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Preface 



This publication is designed to aid personnel in supporting 
the IBM System/34 data communications programs by 
serving as a recall mechanism and as a guide to the program 
listings and microfiche. This publication does not contain 
directions for operating or programming System/34. 

Note: The IBM System/34 System Support Program Pro- 
duct is documented by two manuals: this manual and 
System Support Program Logic Manual: System. 



RELATED PUBLICATIONS 

• IBM System/34 Data Communications Reference 
Manual, SC2 1-7703 

• IBM System/34 System Support Reference Manual, 
SC21-5155 

• IBM System /34 System Data Areas and Diagnostic Aids 
Handbook, LY 2 1-0049 

• IBM System/34 System Support Program Logic Manual: 
System, LY2 1-0050 



First Edition (December 1977) 

This edition applies to version 01 of the IBM System/34 System Support Program 
Product (Program Number 5726-SS1) and to all subsequent versions until otherwise 
indicated in new editions or technical newsletters. Changes are periodically made to the 
specifications herein; before using this manual in connection with the operation of IBM 
systems, be sure you have the current edition. 

Requests for copies of IBM publications should be made to your IBM representative or 
the IBM branch office serving your locality. 

A Reader's Comment Form is at the back of this publication. If the form has been 
removed, address your comments to IBM Corporation, Publications, Department 245, 
Rochester, Minnesota 55901. Comments become the property of IBM. 

©Copyright International Business Machines Corporation 1977 
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How This Manual is Organized 



This manual is divided into two parts: Binary Synchronous 
Communications (BSC) and MULTI-LEAVING Remote 
Job Entry (MRJE) Utility. Each part consists of the fol- 
lowing sections: 

• Introduction contains general information about the 
functions and characteristics of the data communica- 
tions component. 

• Method of Operation contains functional diagrams that 
illustrate the operation of the data communications 
component. The section also contains references to the 
modules and routines that are called to perform the 
functions. 



• Program Organization describes the organization of the 
data communications component through the use of 
storage maps and functional flow diagrams. 

• Directory lists the modules, their descriptions, and their 
associated diagram numbers. 

• Data Areas discusses the data areas that are unique to 
the system component. Other data areas are described 
in the Data Areas Handbook. 

Note: Diagnostic Aids is not included. Information con- 
cerning diagnostic aids is in the Data Areas Handbook. 
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How to Use This Manual 



Diagram numbers in this manual are assigned by part. For example, all diagrams in Part 1 
are numbered 1.x. Any diagram with a zero preceding the first period (Diagram 0.1, for 
example) is a table-of-contents diagram. Each entry in a table-of-contents diagram iden- 
tifies a particular input-process-output diagram. The input-process-output diagrams de- 
scribe functions and are found in the Method of Operation section of each part of this 
manual. 

Figure 1 is the overview table of contents for IBM System/34 programming. Following 
Figure 1 is the table of contents for all programming described in this manual (see 
Diagrams 0.1 and 0.2). 



DIAGRAM TECHNIQUES 

Diagrams in this manual graphically explain the functions of the program. These dia- 
grams are structured from general to detailed levels; namely, the table-of-contents dia- 
grams, one or more overview diagrams, and one or more lower-level diagrams for each 
overview diagram. 



Table-of-Contents Diagrams 

The table-of-contents diagrams (diagrams 0.x) show: 

• The structural relationship of all the diagrams 

• The descriptive title of each diagram 

• The assigned number for each diagram 

Note: The table-of-contents diagrams also show how the functional diagrams within this 
manual relate to the diagrams for the rest of System/34. 

Overview Diagrams 

The input-process-output format is used for both the overview and lower-level diagrams. 

An overview diagram summarizes the functions of a group of related lower-level diagrams 
and is included in the appropriate Method of Operation section. Overview diagrams show: 

• The main input items 

• The main output items 

• A brief description of functions (including references to lower-level diagrams for each 
function) 
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IBM System/34 System Data Areas and 
Diagnostic Aids Handbook, LY2 1-0049 



• System overview 

• Data areas 

• Diagnostic aids 

• I/O controllers 

• Troubleshooting aids 

• Work station utility 



IBM System /34 System Support Program Logic Manual: 
System, LY2 1-0050 



Component/Function 

Starting the system 
Processing commands 
Starting a job 
Running a job 
Terminating a job 
System service programs 
System maintenance programs 
Overlay linkage editor 
System utility programs 
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IBM System /34 Utilities Logic Manual, 
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IBM System/34 System Support Program Logic Manual: Data 
Communications, LY2 1-0051 

Component/Function Diagram Part 

Binary synchronous 1 1 

communications 

MULTI-LEAVING Remote Job 2 2 

Entry utility 

Data communications print A-1 App. A 

utility 



IBM System /34 HPG II Logic Manual, 
LY2 1-0565 

Component/Function Figure Part 

Compiler phase flow 1-1 1 

Object program flow 2-1 2 



IBM System/34 Basic Assembler and 
Macro Processor Logic Manual, LY21-0569 

Component/Function Figure Chapter 

Assembler 1-2 1 

Macro processor 2-2 2 



Figure 1. System/34 Logic Documentation Overview 
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In the following example, arrows and boxes show relation- 
ships by their positions: 

Q All items in INPUT apply to all numbers in PROCESS. 

^p Item ^^ applies only to number Q . 

Q Item ^applies to all numbers in PROCESS. 

^p Items ^y and ^J apply only to number Q . 



Legend 



Control flow (solid arrow) 
!^> Data flow (open arrow) 
Reference number 
Address pointer 




OUTPUT 



Licensed Material— Property of IBM 



Lower-Level Diagrams 

Lower-level diagrams are included in the, appropriate 
Method of Operation section and are arranged to show: 

^P The name of each function that passes control to this 
diagram 

^y The requirements for processing (INPUT) 

© A sequential listing of PROCESS steps 



^^ The results of processing (OUTPUT) 

{^ The name of each function (diagram) that receives 
control 

\*7 An extended description (boxed numbers match those 
in the PROCESS area) 

^0 The module or routine where each step takes place 



From, 
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PROCESS 
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To: 



X.X 
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Part 1. Binary Synchronous Communications (BSC) 



Introduction 

The IBM System/34 binary synchronous communications 
(BSC) programming input/output control system supports 
the data communications capability of the IBM communica- 
tions adapter. 

System/34 can transmit and receive EBCDIC data in either 
the transparent or nontransparent text mode. 

System/34 can transmit and receive ASCII data only in the 
nontransparent text mode. 

Each mode can use intermediate block checking. Trans- 
parent block checking can be used only for receive files. 

System/34 BSC supports the following line types: 

• Point-to-point, nonswitched 

• Point-to-point, switched 

• Multipoint tributary 

BSC can perform these functions: 

• Receive only (get): Receives input data from a remote 
station. 

• Transmit only (put): Transmits data to a remote station. 

• Receive and transmit (get and put): Receives a file and 
then transmits a different file, or transmits a file and 
then receives a different file. 

FUNCTIONAL ORGANIZATION 

This section describes the operating sequence for the 
following BSC functions: 

• Opening BSC files 

• Receiving/transmitting data, which includes: 

— Initializing BSC lines 

— Receiving data (get), transmitting data (put), or 
receiving and transmitting data (get and put) 



— Processing BSC operation ends 

— Logging BSC errors 

• Closing BSC files 

• Terminating the BSC task 

Figure 1-1 shows the functional control and data flow 
of BSC. 

Functionally, System/34 BSC has three steps: 

1 . BSC establishes line control between the transmitting 
station and the receiving station. 

2. BSC incorporates data to be transmitted into a for- 
mat compatible with line control conventions. 

3. BSC recovers data received in the form intended by 
the sender. 

The user's program calls BSC and passes the address of a 
postopen DTF, which serves as the communication area 
between the two programs. BSC formats the IOB area into 
input/output blocks (lOBs) and then establishes line con- 
trol between the sender and the receiver. 

BSC moves data to be transmitted into an available I/O 
buffer, one record at a time, inserts appropriate control 
characters, and transmits the data, one block at a time, to 
the receiving station. 

The receiving BSC accepts transmitted data into available 
I/O buffers. The receiving BSC then moves the data, exclud- 
ing control characters, to the user's logical buffer. 

Note: The assembler user can move the entire physical data 
block, including control characters, to the user's logical 
buffer. See the Data Communications Reference Manual 
for detailed information. 

BSC disables the line (1) when all data has been transmitted, 
or (2) if an unrecoverable (permanent) error occurs when 
the user requests a close of BSC. 
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Figure 1-1. BSC Functional Control and Data Flow 



Opening BSC Files 

Before BSC can process any data, the user must open the 
BSC files. The common open routine (#DMOF) calls the 
BSC open transient (#BSOB) to open the BSC file for the 
DTF pointed to by index register 2 (XR2). BSC updates 
the DTF with any information specified previously by an 
ALTERBSC or OVERRIDE procedure and opens the DTF. 

BSC open looks at the forward chaining pointer in the DTF 
and, if there are any other BSC DTFs in the chain, opens 
them also. 

BSC open is a transient and functions completely within 
the transient area of the main storage nucleus. 



Receiving/Transmitting Data 

When System/34 receives and/or transmits data, BSC: 

• Initializes the BSC lines 

• Performs a get operation, a put operation, or a get-and- 
put operation 
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• Processes BSC operation ends 

• Logs any BSC errors 

Initializing BSC Lines 

If the current request by the user's program is the first request 
for the file, the BSC data management mainline routine 
(#BSDB) calls the line initialization transient (#BSL0) to 
initialize the BSC line. 

#BSL0 sets the file-active and file-used indicators in the 
DTF, formats the lOBs, loads BSC control storage, and 
enables the communications adapter (if the line is inactive 
and the communications adapter is not enabled). For 
switched lines, if the user specifies IDs in the DTF, #BSLO 
allocates an area from the system assign/free area and 
moves the IDs from the user program into this area. Except 
for multipoint lines, #BSL0 then calls the appropriate line 
initialization transient to initialize the line: #BSL2 initial- 
izes switched call lines; #BSL3 initializes switched answer 
lines; #BSL4 initializes point-to-point, nonswitched lines. 
The line initialization transients call the BSC IOS (input/ 
output supervisor) routine (#BSIO) to start all BSC opera- 
tions. The line initialization transients then exit to #BSDB. 
For multipoint lines, #BSL0 returns to #BSDB. 
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While the initialization is in process, #BSDB calls the BSC 
wait routine (#BSIW) to ensure that BSC data transfer is 
complete. If an error occurs, #BSIW sets the user's per- 
manent-error indicator (RPG) or posts an error-completion 
code in the DTF (assembler) and logs the error in the BSC 
error history table. 



Performing a Get, Put, or Get-and-Put Operation 

The data management mainline routine (#BSDB) controls 
the logic flow for BSC data management. After the line 
has been initialized, #BSDB calls #BSMG to deblock the 
data for a get operation or calls #BSMP to block the data 
for a put operation. 

In addition, if blank compression is being used, #BSMG 
calls #BSXP to add the blanks removed by the remote 
station, and #BSMP calls #BSCP to take out the blanks. 
These four routines use the data management move routine 
(#BSMO) to move the data from the physical I/O buffer to 
the user's logical buffer (get operation) or from the user's 
logical buffer to the physical I/O buffer (put operation). 
The BSC IOS routine (#BSIO) is called to start BSC data 
transfer when a physical buffer is ready. 



Processing BSC Operation Ends 

The BSC operation end routine (#BSHB) analyzes all BSC 
operation ends for errors. If an error occurs, the appropriate 
error recovery procedure is executed. If no error occurs 
and the next I/O buffer is ready for data transfer, the BSC 
IOS routine (#BSIO) is called to initiate that transfer. If 
the next buffer is not ready for data transfer, a 2-second 
time-out is started. 

#BSHB also traces every operation end if the trace has 
previously been activated by the TRACE service procedure. 



Logging BSC Errors 

Each time a permanent BSC error occurs, the BSC wait 
routine (#BSIW) makes an entry into the system error his- 
tory table by calling the system logging utility (#CMWO). 

At close time, the BSC close routine (#BSCL) logs text 
sent, text received, and error counters accumulated during 
the job by calling the system logging routine. This routine 
logs the counters for this job and adds these counters to 
the cumulative BSC counters. 



Closing BSC Files 

When BSC processing is complete, the user should close the 
BSC DTFs. The common close routine (#DMCL) gives 
control to the BSC close routine (#BSCL) by setting a 
special operation code in the DTF and requesting the BSC 
task. #BSCL completes the processing of any data in the 
I/O buffer (put files only), disables the BSC line if no new 
files are pending, logs all BSC error and text counters, frees 
the BSC I/O area, and closes the BSC file. #BSCL also 
closes any other BSC files that it finds in the DTF forward 
chain before returning to common close. 

#BSCL is also called by the line initialization transient 
(#BSL0) to close any active files when a new file is pending. 

BSC close is a main storage transient and is brought in only 
when needed to close BSC files or to terminate the BSC 
task. 



Terminating the BSC Task 

Abnormal Termination 

The system termination routine (#CTECM) requests the 
BSC task whenever an abnormal condition occurs. By 
setting a special operation code in the DTF (actually a 
pseudo DTF), system termination causes the BSC close 
transient (#BSCL) to be given control. 

#BSCL disables the BSC line, if it is active, and frees the 
BSC I/O area. 



Normal Termination 

When the BSC task is no longer required by a user program, 
the system termination routine (#CTECM) requests the 
BSC task to terminate, thereby freeing the 6,144 bytes of 
the main storage user area for other tasks. System termina- 
tion requests this function by setting up a special operation 
code in a pseudo DTF in the same manner as for an abnor- 
mal termination. This again gives control to the BSC close 
routine (#BSCL), which performs the same functions as 
done for an abnormal termination in addition to terminat- 
ing the task. 
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INPUT/OUTPUT 

Input required by System/34 BSC consists of the following: 

• A 68-byte DTF 

• A logical buffer (addressed from the DTF) 

• A communications configuration record 

• A communication specification block (CSB) 
Output depends on the program being run. 

SYSTEM INTERFACES 

System/34 BSC programming support consists of seven 
main storage transients and one main storage data manage- 
ment and IOS routine that reside in the system library. 
BSC interfaces with the SSP, BSC control storage, hardware, 
and the user's RPG II or basic assembler program. 



Hardware Interface 

The BSC task communicates with the hardware through 
the BSC control storage routine. 



User Program Interface 

A System/34 user can interface to BSC by coding a source 
program in either RPG 1 1 or basic assembler language 
(making use of macroinstructions). The source program 
is then processed by the RPG II compiler or the assembler, 
and a load module is created and stored in the system 
library. The scheduler program loads the load module 
from the library into the user portion of main storage 
for execution. 

The RPG II compiler or the assembler generates a BSC DTF 
for each BSC file in the source program. The DTF is used 
to pass information between the user's program and the 
BSC task. 



SSP Interfaces 

BSC operates under control of the SSP. The SSP controls 
BSC file allocation, termination, open, and close. It also 
controls BSC usage of the system log and trace functions. 

BSC operates as a separate task from the user program. It is 
loaded into the user portion of main storage and attached 
as a task by the allocate function. By existing as a separate 
task, BSC runs independent of the user program, thus 
allowing the user program to be swapped to disk. BSC 
main storage transients (except BSC open) run under con- 
trol of the BSC task, and are loaded into the main storage 
transient area of the nucleus as they are needed. Index 
register 2 (XR2) points to the BSC DTF whenever the 
common open routine (#DMOF) calls the BSC open tran- 
sient (#BSOB). The common close routine (#DMCL) and 
the system termination routines invoke the BSC close and 
terminate functions by setting special operation codes in 
the DTF (pseudo DTF for terminate) and interfacing to 
the BSC task in a similar fashion to a user program. In the 
latter cases, XR2 also points to the DTF. 



OPERATIONAL CONSIDERATIONS 

System/34 BSC executes according to the user's job require- 
ments and according to the user's system configuration. 
Specific considerations affecting BSC are: (1) the function 
required to run the job, (2) the mode in which the data is 
to be sent, (3) the line type used, and (4) the control state- 
ment and procedure command specifications. 



COMMANDS AND CONTROL STATEMENTS 

The OVERRIDE and ALTERBSC procedures (or the SETB 
and SETR utility control statements for the $SETCF utility) 
alter BSC configuration information. 

The ALTERBSC procedure alters hardware and modem 
information. 

The OVERRIDE procedure overrides certain parameters 
specified by the user program or specifies certain param- 
eters that cannot be specified by the user program. 



Control Storage Interface 

The BSC line initialization transient (#BSL0) loads the BSC 
microcode into control storage via an SVC instruction. 
Communication between the BSC task and the BSC micro- 
code is done via SVCs and an IOB. 
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ERROR RECOVERY 
Types of Errors 

BSC errors can be caused by: 

• System hardware 

• Communications adapter 

• Operator or programmer 

Errors Caused by System Hardware 

In general, nonrecoverable errors on non-BSC devices that 
occur during execution of a BSC program terminate BSC 
program execution. Recoverable errors on a non-BSC 
device may cause a communications adapter time-out if 
extensive time is required to recover from the error. BSC 
error recovery procedures may be required to reestablish 
line connections and synchronization. 

Permanent Errors Caused by the Communications Adapter 

Recovery from a BSC hardware error is handled by BSC 
programming support. The permanent-error condition is 
displayed on the system log device, and the error is 
recorded in the system error history table. 

For RPG II users who have specified a permanent-error 
indicator, the error condition is displayed as an informa- 
tional message and control is returned to the RPG II pro- 
gram. If no permanent-error indicator has been specified, 
a message requiring operator response is displayed either 
by the BSC task or the RPG 1 1 program. 

For the basic assembler user, all permanent-error messages, 
except some open and close messages, are displayed as 
informational messages and control is returned to the user 
program with a completion code in the DTF. 

Errors Caused by an Operator or Programmer 

Error messages are displayed on the system log device for 
errors caused by invalid ALTERBSC and OVERRIDE pro- 
cedure commands or invalid SETB and SETR utility con- 
trol statements. 



Error Recovery Diagnostics and Aids 

System/34 BSC error recovery diagnostics and aids include: 

• Automatic wrap test for unrecoverable errors 

• Error logging in the BSC error history table 

• Error retry count 

• Message display 

• Interrupt trace if specified in the TRACE command 

• Permanent-error indicator (RPG II only) 

• Exact completion code in DTF (basic assembler only) 

Automatic Wrap Test 

The BSC close routine (#BSCL) automatically calls (via a 
supervisor request) a control storage wrap test routine when 
an unrecoverable BSC hardware error occurs. The wrap 
test routine checks the BSC control storage, communica- 
tions adapter, and modem (if an IBM internal modem is 
used). Based on the results of this check, BSC displays an 
operator message indicating the cause of the error. 



Error Logging 

BSC logs all BSC errors in a BSC error history table. This 
table is a push-down stack that shows the last 21 temporary 
or permanent BSC errors that have occurred. 



Error Retry Count 

By using the SETB utility control statement or the 
ALTERBSC procedure, the BSC user can specify from 1 
through 255 error retries to be performed before the BSC 
line is aborted when an error condition occurs. If an error 
retry count is not specified by the user, the error retry 
count defaults to 7. (The assembler user can also specify 
this parameter in the $DTFB macroinstruction.) 
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Message Display 



SYSTEM REQUIREMENTS 



BSC uses the SSP system log function to display informa- 
tion and error messages from the system library. There are 
two types of BSC messages: (1) messages that require no 
response, and (2) messages that require an operator response 
to continue processing. 



Trace Option 



System/34 BSC runs on any model of System/34 that has 
the communications adapter installed. 

BSC requires 6,144 bytes of main storage. This does not 
include the transient routines, which are brought into the 
2,048-byte system main storage transient area as needed. 
Space is also required in the system queue space for the 
BSC I/O area, which consists of the following: 



The BSC user can request a trace of the BSC operation ends. 
Trace output can be used to diagnose problems and errors. 



• lOBs (maximum of 4, each with a length of 40 bytes) 



• Switched IDs (maximum of 8 bytes) 



Permanent-Error Indicator (RPG II Only) 

When a BSC permanent error occurs, a permanent-error 
indicator is set and the normal completion code (hex 40) is 
posted in the BSC DTF. The BSC user may then code an 
error recovery routine within the RPG II program to allow 
the program to continue processing without operator 
intervention. 



• Physical I/O buffers (1 or 2 buffers, each with a maxi- 
mum size of 4,096 bytes) 

If switched IDs are specified via the OVERRIDE procedure 
(or via the SETR utility control statement), the IDs are 
moved into the BSC I/O area. If switched IDs are specified 
in the user program, the specified IDs are moved into a 32- 
byte area that #BSL0 allocates within the system assign/ 
free area. 



DTF Completion Code (Basic Assembler Only) 

The basic assembler user is notified of a permanent error by 
a completion code (ofJier than hex 40) in the DTF 
($BSCMP). The user can use this completion code to do 
error recovery. 
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Method of Operation 

This section contains the logical functions of BSC using an 
overview (see Diagram 1) and an input-process-output dia- 
gram for each function. 

For detailed information on input-process-output diagrams, 
see Diagram Techniques in How to Use This Manual at the 
front of this publication. 



p INPUT 



Configuration 
record 

Communication 
specification block 

Preopen DTF _ 

Postopen DTF IOB 

Logical buffer 

Physical I/O buffer 

BSC work area 

IOB 

BSC work area 

System trace table 

System error history 
table 

System text and 
error counter table 



DTF 



Pseudo DTF 



Diagram 1. BSC Overview 



I 



PROCESS 



i r 



o 



Opens BSC files (1.1). 



Initializes BSC lines (1.2). 



Processes user requests: 

• Receive (get) (1.3). 

• Receive and transmit (get and put) 
(1.4). 

• Transmit (put) (1.5). 



^^KJ Processes BSC operation ends and logs 
BSC errors (1.6). 



-v^Q Closes BSC files (1.10). 

in 

■vjjjj Terminates BSC task (1.10). 



OUTPUT 



^> 



Postopen DTF 
Postopen CSB 
BSC I/O area 
Error messages 
^> Adapter enabled 



> 



> 



I I 



£> 



> 



Adapter requests 

DTF completion 
code 

Error messages 

Error history table 

Trace 

Error and text 
counters 

IOB 



DTF 

Error messages 

BSC task detached 
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From: Common Open 




PROCESS 



Updates DTF with OVERRIDE data. 



Calculates I/O buffer and I/O area sizes [ 
and allocates I/O area (only once for 
all DTFs). 



Formats DTF to postopen status. 



^> Q Formats communication specification 
block. 



Moves any switched line IDs specified 
via OVERRIDE to the BSC I/O area. 

If more BSC DTFs, returns to Step 1 . 



r 



OUTPUT 



£>VXR2 

^Updated DTF 
Error messages 



I I 



^>BSC I/O area 



I I 



£>,XR2 

V 



Postopen DTF 



X 



•XR1 



Postopen CSB 



;>xri 




Updated BSC 
I/O area 



To: Common Open 



DESCRIPTION 



MODULE/ 
ROUTINE 



Reads the communications configuration from disk. 

• Determines the I/O buffer size from block size, record length, and ITB mode (if used) or record 
separator mode (if used). If the I/O buffer size is greater than 4,096 bytes, posts a 3301 error. 
(The size is saved in $BSDL.) 

• The BSC I/O area size is the total sizes of I/O buffer, IOBs,and switched IDs. Area is allocated 
from system queue space. If area cannot be allocated from system queue space, posts a 3288 error. 

• Sets normal completion code (hex 40) in $BSCMP. 

• Sets on file-opened flag ($BSFILOP) in $BSAT2. 

• Moves disk address on #BSL0 to CSBDLCS. 

• Sets CSBDLNDX to 0. 

• Sets l/O-area-allocated flag. 

• Sets CSB-opened flag. 

• Moves BSC I/O area address to CSB. 

If switched line IDs were specified via the OVERRIDE procedure (or the SETR utility control state- 
ment), moves them from the display station communications configuration record to the BSC I/O area. 

Chains forward through DTFs until a device code ($BSDEV) of hex 80 (BSC) is found and returns to 
Step 1, or exits if forward chain pointer ($BSCHB) equals hex FFFF. 



#BSOB 



Diagram 1.1. BSC Open 
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From: Get and Put, 1 .4, Step 1 



■ INPUT 



XR1 
CSB 
•XR2 
BSC work area 




PROCESS 



£> 



Initializes BSC work area. ^ZZZZ 

Loads control storage. 

Enables communications adapter. 






E 



OUTPUT 



BSC work area 



^^Adapter enabled 



If an active file is in process, closes that 
file. 



Formats lOBs. 



Initializes the lines: 

• Multipoint line (1.2.1). 

• Switched call line (1.2.2). — 

• Switched answer line (1.2.3). 

• Point-to-point, nonswitched line 
(1.2.4). 



I I 



k made with 
remote station 




To: Get and Put, 1 .4, Step 2 



DESCRIPTION 



MODULE/ 
ROUTINE 



Initializes all bytes of the BSC work area. Initializes the line control bytes to ASCII or EBCDIC. 

Loads ASCII or EBCDIC BSC microcode into control storage. 

Issues enable SVC. 

Before a new file can be processed, closes the old active file and purges any data (if the file is a put file). 



#BSLO 



#BSCL 



#BSLO 



Diagram 1.2. Line Initialization 
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INPUT 



From: Line Initialization, 1 .2, Step 3 

m PROCESS 



BSC work area 

Multipoint IOB 

Multipoint I/O 
area 




> 



If get file, receives addressing sequence. 

If put file, receives polling sequence. 

Invokes automatic response between 
files. 




OUTPUT 



To: Wait for Get, 1.3.1 
Wait for Put, 1.5.1 



DESCRIPTION 



MODULE/ 
ROUTINE 



For new file, determines whether receive-initial operation should be started or if automatic response is 

already in effect. 

Sets up a receive-initial operation to receive an addressing sequence from the control station. 

Checks the validity of the response. 

Sends ACKO when a valid addressing sequence followed by ENQ is received. 

Sends EOT if poll is received. 

If invalid response, retries the operation until the error retry count is exceeded. 

Sets up a receive-initial operation to receive a polling sequence from the control station. 

Performs the receive-initial operation. 

Checks the validity of the response. 

Starts a 2-second time-out when a valid polling sequence followed by ENQ is received. 

Sends RVI if ADDR sequence received. 

If invalid response, retries the operation until the error retry count is exceeded. 

Starts receive-initial operation after EOT received. 

Starts receive-initial operation after EOT transmitted for put file. 

Starts receive-initial operation after EOT transmitted because of permanent error. 

Checks the validity of the response to receive-initial. 

Transmits EOT to poll, and RVI or NAK to address with a transmit/receive-initial operation. 



#BSRI 



#BSCKRI 



#BSRI 



#BSCKRI 



#BSAUTO 



#BSCL 



#BSMPEOT 



#BSCKRI 



Diagram 1.2.1. Multipoint Line Initialization 
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■ INPUT 



From: Line Initialization, 1.2, Step 3 

PROCESS 



c 

c 

c 



XR2 

BSC work area 
BSIOB 
OB 
XR1 



Communication 

specification 

block 




P. 



> 



Issues messages. 

| Performs ID exchange. 

Completes initialization for transmit 
and receive files. 



^> 




OUTPUT 



c 



XR2 

BSC work area 



CXR1 
Comr 



ommunication 
specification 
block 



To: Wait for Get, 1.3.1 
Wait for Put, 1.5.1 



DESCRIPTION 



MODULE/ 
ROUTINE 



Issues a message telling the operator to dial the required number and establishes a line connection. 

• Sets up ID field (if $BSTID indicates an ID is to be sent) and ENQ in the send buffer for a transmit/ 
receive operation. 

• Performs transmit/receive operation to exchange ID-ENQ sequence. 

• If an ID is to be received, compares ID field received with $BSRID for validity. 

• If ACKO is received following an ID exchange for a transmit file, starts a 2-second time-out and returns 
to the calling routine. 

• If ACKO is received following an ID exchange for a receive file, sends EOT to release control of the line. 

• Starts a receive-only operation after #BSIO sends EOT for a receive file. 

• If the ACKO response is not received for the receive operation, starts a 2-second time-out and retries 
the operation until the error retry count is exceeded. 

• If the error retry count is exceeded, initiates an error message or sets the RPG II permanent-error 
indicator for the RPG II user. 



#BSLO 



#BSL2 



#BSIO 



#BSL2 



#BSIO 



#BSL4 



#BSL2 



#BSLO 



Diagram 1.2.2. Switched Call Line Initialization 
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■ INPUT 



From: Line Initialization, 1 .2, Step 3 

pi PROCESS 



c 
c 
c 



XR2 

BSC work area 

BSIOB 

IOB 

XR1 

Communication 

specification 

block 




> 



| Issues messages. 

[Performs ID exchange. 

| Completes initialization for transmit 
and receive files. 



> 




OUTPUT 



c 
c 



XR2 

BSC work area 

XR1 

Communication 

specification 

block 



To: Wait for Get, 1.3.1 
Wait for Put, 1.5.1 



DESCRIPTION 



MODULE/ 
ROUTINE 



Issues a message telling the operator to answer to establish the line connection. 

• Sets up a receive-initial operation to receive the remote station's ID (if used) and ENQ. 

• Performs a receive-initial operation to receive the remote station's ID (if used) followed by ENQ. 

• Determines if the remote station has sent ENQ preceded by an optional ID and checks the validity 
of the ID. 

• Sets up to send ACKO preceded by an optional ID if a valid ID-ENQ was received. 

• Sends ID-ACKO sequence. This completes initialization for a receive file. 

• Receives EOT from the remote station for a transmit file. 

• Sends ENQ if this is a transmit file and EOT was received from the remote station. 

• Starts a 2-second time-out and returns to the calling routine if ACKO was the remote station's response 
to the ENQ for a transmit file. This completes line initialization for a transmit file. 

• If the error retry count is exceeded, initiates an error message and disables the line or, for the RPG II 
user, sets the permanent-error indicator. 



#BSLO 



#BSL3 



#BSIO 



#BSL3 



#BSIO 



#BSL3 



#BSIO 



#BSL3 



#BSLO 



Diagram 1.2.3. Switched Answer Line Initialization 
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From: Line Initialization, 1.2, Step 3 



INPUT 



C 

c 



XR2 

BSC work area 

BSIOB 

JOB 



CXR1 
C 



ommunications 
control block 




PROCESS 



1> 



If a receive file, receives initial. 

If a transmit file, sends ENQ to start 
data transmission. 



> 




OUTPUT 



C 

c 

c 



XR2 

BSC work area 

BSIOB 

IOB 

XR1 

Communications 
control block 



To: Line Initialization, 1.2 



DESCRIPTION 



MODULE/ 
ROUTINE 



• Sets up a receive-initial operation to receive an ENQ. 

• Performs the receive-initial operation. 

• Determines if an ENQ was received. 

• Sends an ACKO response to ENQ. 

• Returns to the calling routine. 

• If an ENQ was not received, retries the operation until the error retry count is exceeded. 

• If the retries fail, initiates an error message or sets the RPG 1 1 permanent-error indicator. 

• Sends ENQ. 

• Checks for an ACKO response to ENQ. 

• If ACKO is received, starts a 2-second time-out and returns to the calling routine. 

• If ACKO is not received, retries the operation until the error retry count is exceeded. 

• If the retries fail, initiates an error message or, for the RPG II user, sets the permanent-error indicator. 



#BSL4 



#BSIO 



#BSL4 



#BSIO 



#BSL4 



#BSLO 



#BSIO 



#BSL4 



#BSLO 



Diagram 1.2.4. Point-to-Point, Nonswitched Line Initialization 
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From: Get and Put, 1 .4, Step 3 









■ OUTPUT mmmammmm 


^-XR2 

^Postopen DTF 


^ 


Bj| Waits for data transfer to complete 
(1.3.1). 




> 


^-XR2 


i"* 












>»»Postopen DTF 






Q Deblocks and moves data from the 








s $BSWKA 




physical I/O buffer to the user's logical 
buffer (1.3.2). 






•$DTFWKB 


Nk.BSC work area 










^User's logical 
buffer 


•-WKABKX 










^-$DTFWKA 
^BSC work area 


^Physical I/O 










buffer 










>^-BSIOB 












>MOB 






J 


^i 








Jo: 


Get and Put, 1.4, 


Step 4 


Diagram 1.3. Get 
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INPUT 



From: Get, 1.3, Step 1 

■i PROCESS 



c 
c 



XR1 
IOB 
XR2 
BSC work area 



x-IOBCAR 



Physical I/O 
buffer 




> 



If wait is not necessary, goes to Step 4. 

Ensures that the data transfer is com- 
plete for the IOB being waited on. 

Processes any operation ends (1.6). 

If the error indicator is on, logs any 
errors (1.6.1). 

Tests the IOB completion code. 



O 




OUTPUT 



c 



XR1 

IOB 

System log 
parameter list 



CXR2 



BSC work area 



To: Get, 1.3, Step 2 



DESCRIPTION 



MODULE/ 
ROUTINE 



If a permanent error has occurred or a data transfer is not in progress (IOBCMP<84), goes to Step 4. 

Issues a wait to ensure that data transfer is complete. IOBCAR is the address of the last byte received. 
IOBRLN is the length of the data received. 



Checks BSFL3D in the work area to see if an error should be logged. 

If IOBCMP equals hex 40 or hex 42, returns to the caller. Otherwise, displays an operator message and 
sets the permanent error indicator for the RPG user. 



#BSIW 



#BSHB 



#BSIW 



Diagram 1.3.1. Wait for Get 



BSC 1-15 



Licensed Material— Property of IBM 



INPUT 



From: Get, 1.3, Step 2 

PROCESS 




^-BSIOB 



c: 



IOB 

WKABKX 

Physical I/O 
buffer 



Blanks the logical buffer. 

If 3780 mode, performs expansion 
(1.3.2.1). 

If the first time for this buffer, initializes 
the data block pointer. 

| Moves data from the physical I/O buffer 
to the user's buffer. 

| Checks for end of block. 

| Sets the return code for normal completion. 

I If this operation is complete, initiates the 
next I/O operation. 



> 




OUTPUT 



C 

c 



XR2 

BSC work area 

BSIOB 

IOB 

WKAWKB 

Logical buffer 



To: Get and Put, 1 .4, Step 4 



DESCRIPTION 



MODULE/ 
ROUTINE 



#BSMG 



WKAOPC indicates the direction of the move, and WKARCL indicates the length of the move. 
Checks for end of block to determine if this operation is complete. 
Sets IOBCMP field in the IOB to hex 40. 
Cancels 2-second time-out if line is not busy. 



#BSMO 



Diagram 1.3.2. Data Deblock 
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INPUT 



From: Data Deblock, 1.3.2, Step 1 

■i PROCESS 



•XR2 

'BSC work area 
^-WKABKX 



C 
C 



Physical I/O 
buffer 



C 



XR1 
IOB 




> 



If the first time for this buffer, 
initializes the data block pointer. 

For truncated records, scans the I/O 
buffer for an IRS character. 

For compressed records, scans the 
I/O buffer for an IGS or IRS 
character. 

Sets the length of the move. 

Moves part or all of the record to the 
logical buffer. 

Returns to Step 4 unless an IRS 
character has been found. 



=> 



OUTPUT 



c 



XR2 

BSC work area 
•WKABKX 



c 

^Physical I/O 
buffer 




To: Data Deblock, 1 .3.2, Step 4 



DESCRIPTION 



MODULE/ 
ROUTINE 



#BSXP 



| Sets WKAERL to the length of the data to be moved from the I/O buffer to the logical buffer. 
WKAOPC indicates the direction of the move, and WKAERL indicates the length of the move. 



#BSMO 



#BSXP 



Diagram 1.3.2.1. Expansion 
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From: Wait, 1.8 



INPUT 



c 



c 
c 



Postopen DTF 
BSC work area 
BSIOB 
IOB 



^WKAWKB 



C 



User's logical 
buffer 

WKABKX 

Physical I/O 
buffer 




PROCESS 



^> 



If required, initializes the BSC line 
(1.2). 

Determines the type of operation to 
be done next — get or put. 

Performs get (1 .3) or put (1 .5). 

Returns to the user. 



> 




OUTPUT 



•XR2 
^Postopen DTF 

•$BSWKA 
^BSC work area 

(BSIOB 
IOB 
/-WKAWKB 



MJser' 



( 



s logical 
buffer 

WKABKX 

Physical I/O 
buffer 



To: User Program 



DESCRIPTION 



MODULE/ 
ROUTINE 



Checks value of WKAAT1 to determine whether a put or get operation is to be done next. 



Posts system intertask routine (#SVTTC), which exits back to the user program. 



#BSLO 



#BSDB 



#BSMP 



#BSPOST 



Diagram 1.4. Get and Put 
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INPUT 



c 



From: Get and Put, 1 .4, Step 3 

■I PROCESS 



Postopen DTF 



^$BSWKA 



c 
c 



BSC work area 

BSIOB 

IOB 

WKAWKB 

User's logical 
buffer 



Diagram 1.5. Put 




> 



Waits for the data transfer to complete 
(1.5.1). 

Blocks and moves data from the user's 
logical buffer to the physical I/O 
buffer (1.5.2). 



> 




OUTPUT 



CXR2 
Postopen DTF 
x-$BSWKA 



( 



BSC work area 

WKABKX 

Physical I/O 
buffer 



To: User Program or Get and Put, 
1 .4, Step 4 
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From: Put, 1.5, Step 1 



INPUT 



C 

c 

(. 



•XR1 

k IOB 

-IOBSTAR 

^Physical buffer 

,XR2 

k BSC work area 




PROCESS 



> 



If a permanent error has occurred or data 
transfer is complete, goes to Step 4. 

Ensures that the data transfer is complete 
for the IOB being waited on. 

Processes any operation ends (1.6). 

If the error indicator is on, logs the 
error. 

If the completion code is hex 40 or hex 
42, exits; otherwise, displays an operator 
message and sets the permanent error 
indicator for the RPG user. 



> 




OUTPUT 



C 

c 



^XR1 

k IOB 

-XR2 

k BSC work area 

.WKACSB 

k CSB 



To: Put, 1.5, Step 2 



DESCRIPTION 



MODULE/ 
ROUTINE 



#BSIW 



Issues wait to ensure that the data transfer is complete. 



If LOGPROC in the BSC work area is on, logs an error in the BSC error history table. 



Diagram 1.5.1. Wait for Put 
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From: Put, 1.5 



INPUT 



C 



XR2 
SC work area 



xWKAWKB 

Njser's logical 
buffer 




> 



PROCESS 



If not enough room for the current record 
in the physical buffer, transmits the data 
from the physical buffer. 

Prepares the physical buffer for the next 
record(s). 

| If specified, compresses or truncates the 
record and moves it to the physical I/O 
buffer. 

Moves the data from the user's logical 
buffer to the physical I/O buffer. 

| Updates the work area (WKABKX) to 
point to the next available space in the 
physical buffer. 



> 




OUTPUT 






■ XR2 

k BSC work area 

,WKABKX 



^Physical I/O 
buffer 



To: User Program 



DESCRIPTION 



MODULE/ 
ROUTINE 



Uses information from the work area and IOB to determine if the physical buffer can hold the current record. 

Sets WKABKX to the start of the physical buffer. Moves STX or DLE-STX to the start of the buffer. (DLE is 
used for transparent EBCDIC.) 

• For compression, replaces two or more blanks with IGS and blank count. 

• For truncation, omits all trailing blanks from the end of the record. 

• Inserts IRS at the end of the record. 

• Moves data from the logical buffer to the physical buffer. 

WKAOPC indicates the direction of the move, and WKARCL indicates the length of the move. 



#BSMP 



#BSCP 



#BSMP 



Diagram 1.5.2. Data Block 
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From: Wait, 1.8 



m INPUT 



c 

X E 

c 



,XR2 

k BSC work area 

-XR1 

k IOB 




PROCESS 



> 



Builds and logs a trace entry for a 2-second 
time-out or data transfer operation. 

If a 2-second time-out, processes it. 

If line initialization is in process, posts IOB 
and returns. 

If an error caused the operation end, does 
error recovery (1.6.1). 

Increments counters. 

If next buffer is ready for data transfer, 
initiates data transfer. 

If next buffer is not ready for data 
transfer, starts a 2-second time-out. 



> 




OUTPUT 



c 



^XR2 

k BSC work area 
<XR1 
k IOB 
Adapter request 



To: Wait for Get, 1.3.1, or 
Wait for Put, 1.5.1 



DESCRIPTION 



MODULE/ 
ROUTINE 



• If a 2-second time-out, builds sense and Q- and R-bytes in work area (TRCSNS, TRCQR). Sets transmit 
and receive bytes to hex FF. 

• For transmit or receive operations, saves first and last 3 bytes transmitted and first and last 2 bytes 
received. For receive-initial or receive-only operations, saves only receive bytes. 

• Uses system trace facility to log operation end. 

For a receive 2-second time-out, sends WACK; for a transmit 2-second time-out, sends TTD. 
If line initialization is in process, posts IOBCMP with normal completion (hex 40) and returns. 



Increments BSLTBTFJ for transmit files or BSLTBRFJ for receive files. These will be written to the text 
and error counter table on disk. 



#BSHB 



Diagram 1.6. Processing Operation Ends 
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INPUT 



From: Processing Operation Ends, 1.6, Step 4 

■i PROCESS i 



c 



'XR2 

k BSC work area 

-XR1 

'IOB 




> 



U For software receive errors, does software 
receive error recovery procedure. 

3 F°r software transmit errors, does soft- 
ware transmit error recovery procedure. 

3 For hardware errors, does hardware error 
recovery procedure. 

Q For permanent errors, does permanent 
error processing. 

PJ Logs errors in BSC error history table. 



m OUTPUT 



=> 




XR2 

BSC work area 

XR1 

IOB 

Error history 
table 



To: Processing Operation Ends, 1 .6, Step 5 



DESCRIPTION 



MODULE/ 
ROUTINE 



• When DISC is received, sets off BSC active indicator in the work area (BSFLGD). When preceded by TTD, 
posts a permanent error in the BSC work area (BSLBSCCC) and increments the forward-abort-received 
counter (BSLFARFS). If not preceded by TTD, posts BSLBSCCC with EOF and resets the interrupt. 

• When an EOT is received that is preceded by a TTD, posts a permanent error in the BSC work area 
(BSLBSCCC) and increments the forward-abort-received counter (BSLFARFS). When an EOT is received 
that is not preceded by a TTD, posts BSLBSCCC with EOF and resets the interrupt. 

• For an invalid response (a response other than ENQ as the last character received), retries the operation. 

• When ENQ is received in response to WACK, initiates data transfer or starts a 2-second time-out. 

• Responds NAK to TTD. 

• When an invalid ACK is received, sends ENQ. If the response is another invalid ACK, retransmits text. 

• If NAK is received in response to TTD (forward abort is in progress), posts a permanent error in IOBCMP 
and sends EOT. When NAK is received in response to TTD, sends the next block of text or starts a 2- 
second time-out. When NAK is the response to text transmitted, retransmits the block of text. 

• If WACK is received, sends ENQ. 

• When RVI is received, sets RVIRCV flag and continues with successful text transmission processing. 

• When EOT is received, posts a permanent error in the BSC work area (BSLBSCCC) and increments the 
abort-received counter in the work area (BSLABTFS). 

• When disconnect is received, sets the adapter-inactive indicator in the work area, posts lost connection in 
the BSC work area, and increments the abort-received counter in the work area (BSLABTFJ). 

• When ENQ is received, sends ENQ to an invalid response of ENQ. 

• Any other invalid response is not recognized and ENQ is sent. 



#BSHB 



Diagram 1.6.1 (Part 1 of 2). Error Recovery Procedures 
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DESCRIPTION 



MODULE/ 
ROUTINE 



• For an ASCI I error, posts a permanent error in the BSC work area. 

• When a transmit-adapter check has occurred, increments the transm it-adapter-check counter (BSLACTFJ) 
in the BSC work area, posts the error in the work area (BSLBSCCC), and sends ENQ. When a receive - 
adapter check has occurred, increments the receive-adapter check counter (BSLACRFT) in the BSC work 
area, posts the error in the work area (BSLBSCCC), and does a receive-only operation. 

• For a lost connection, increments the lost-connection counter (BSLDTOFJ) in the BSC work area and 
posts the error in the work area (PBLBSCCC). 

• For receive time-out errors, increments the receive time-out counter (BSLRTOFJ) in the BSC work area 
and sets up the I OB to do a receive-only operation. 

• When a data check has occurred, increments the data-check counter (BSLDCKFS) in the BSC work area 
(BSLPSCCC), and sends NAK. 

• Builds the error history table list. 

• If BSC is active for receive files, sends EOT or DISC. For transmit files, sends forward abort sequence: 
TTD followed by EOT or DISC. 

• Disables the adapter when going inactive. 

• Posts IOB (IOBCMP) with error condition from the BSC work area (BSLBSCCC). 

The following bytes are recorded: 
■•■" Q-byte ' ■ 

• R-byte 

• Sense byte 

• Error retry count 

• Completion code 

• Multipoint tributary station address 



Diagram 1.6.1 (Part 2 of 2). Error Recovery Procedures 
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From: Caller 



INPUT 



XR2 

BSC work area 

User request 
byte 

User TCB 




PROCESS 



> 



Ensures that the user is in main storage. 

Updates the DTF. 

Sets the RVI indicator, if necessary. 

Posts the user. 

Posts for a message. ' ~ 



I 



OUTPUT 






DTF 

RVI indicator 

Request byte 




^^ Error message 



To: Wait, 1.8, Step 1 



DESCRIPTION 



MODULE/ 
ROUTINE 



Posts the system task-to-task interface routine (#SVTTC) with completion code indicating that control should 
be returned to the BSC task. 

Moves DTF bytes from the BSC work area to the BSC DTF. 

If the operation end processor (#BSHB) has received RVI and set the RVI indicator in the work area, trans- 
lates the RVI indicator address and sets the indicator. 

Sets completion code indicating return to user, and posts the system task-to-task interface routine (#SVTTC). 

If a BSC error has occurred, posts the system task-to-task interface routine (#SVTTC) indicating that the 
BSC message transient (#BSMD) should be called. 



#BSIW 



Diagram 1.7. Post 
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INPUT 



From: User Request, or Get, 1 .3, or 
Put, 1.5 

~" m PROCESS 




c 



XR2 

BSC work area 

XR1 

IOB 



CXR1 
i 



c 



Event control 
block 

XR2 

DTF 



> 



Waits for the operation to complete 
(either get, put, or user request). 



LC 



OUTPUT 



I I 



XR1 



IOB 



Processes any operation ends (either, 
get or put). 



"J^ tcl If user request: 

• Readies BSC task for more requests. 

• Translates DTF address. 

• If close operation code, closes. 

• Starts data transfer or exits. 



^>XR1 

Sob 




v^ XR2 

Xi 



DTF 



To: Caller 



DESCRIPTION 



MODULE/ 
ROUTINE 



For a user request, returns control after the wait with XR1 pointing to the BSC TCB. 



• Issues PIQ to allow more user requests. 

• Logical address of DTF must be translated to a BSC task address. 

• If the DTF operation code is close or terminate, closes the file or terminates the BSC task. 

• If this request is from the user, processes the request; if this request is due to a BSC-initiated action (such 
as posting an error message), returns to the calling program. 



#BSIW 



#BSCL 



Diagram 1.8. Wait 
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From: Caller 



■INPUT 



XR2 contains 
address to be 
translated 



CXR1 
I Icpr 



User TCB ATR 
stack 




PROCESS 



C> 



Uses bits through 4 of the high-order 
byte of XR2 to find the correct user 
ATR. 

Moves three ATRs from the user to BSC 
ATR stack positions 29 through 31. 

Sets bits through 4 of the high-order 
byte of XR2 to point to BSC ATR stack 
position 29. 



O 




OUTPUT 



XR2 contains 

translated 

address 

BSC TCB ATR 
stack 



To: Caller 



DESCRIPTION 



MODULE/ 
ROUTINE 



#BSATR 



Diagram 1.9. ATR Translation 
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From: User Request 



INPUT 



/ ^-XR2 

C 



DTF 

BSC work area 



c 



Physical I/O 
buffer 



c 



BSC work area 




PROCESS 



> 



JJ Purges buffers for transmit files. 

K| If necessary, sends ACK. 

H Sends EOT, DISC, or STX-ETX. 

PJ If no new files are pending, disables the 
adapter. 

|ij Logs the BSC error and job counters in 
the BSC work area. 

[•J If an error occurs, logs an error message. 

F^ If a permanent error occurs, loads the 
wrap test and issues SVC to execute it. 

(•J Posts the completion code and reformats 
DTF. 

£J Frees the BSC I/O area from system queue 
space. 

^2 I* necessary, detaches the BSC task. 

Ill If necessary, frees the part of the system 
assign/free area where the switched IDs 
were saved. 

||2J For a multipoint line, starts a receive- 
initial operation. 



£> 




OUTPUT 



CXR2 
Preopen DTF 
Preopen CSB 
Error messages 

Updated system 
text and error 
counter table 



To: Caller 



DESCRIPTION 



MODULE/ 
ROUTINE 



Note: If BSC close is being called because of user or task termination, executes only Steps 4, 5, 9, and 10. 

Q If file being closed is a get file, file pending is a get file, and 3740 multiple file support is being used, then 
goes to Step 4. 

Q If the file being closed is a get file, 3740 multiple file support is being used, and either no new files are 
pending or the pending file is a put file, then transmits ACK. 

9 • If no new files are pending and the file being closed is on a nonswitched line, or if a new file is pending, 
then transmits EOT. 

• If no new file on a switched line is being closed, then transmits DISC. 

• If the file pending is a put file, file being closed is a put file, and 3740 multiple file support is being used, 
then transmits STX-ETX (null record). 



#BSCL 



Diagram 1.10 (Part 1 of 2). BSC Close/Terminate 
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DESCRIPTION 



MODULE/ 
ROUTINE 



Stores job counters in BSC text and error counter table on disk using control storage transient. Control 
storage transient also adds these counters to cumulative counters. 



flfl If SBSOPC in DTF is 0. terminates the BSC task. 

DB- 

||2J If an EOT is to be transmitted for a transmit file and if a new file is pending or the user issued a put EOF, 
transmits EOT with a transmit/receive-initial operation before returning to the caller. 



Diagram 1.10 (Part 2 of 2). BSC Close/Terminate 
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Program Organization 

This section includes: 

• A storage map indicating the layout of the program 

• A description of each module within the program 

• A description of the control flow between the modules 



CONTROL FLOW DIAGRAMS 

Figures 1-3 through 1-16 are control flow diagrams that 
describe each module within the program and the control 
flow between the modules. A bullet (•) indicates a process 
step and a diamond (♦) indicates a decision. 



BSC STORAGE MAP 

The BSC mainline code, which requires 6K bytes, is loaded 
into the user portion of main storage at the time the user 
allocates the BSC files. Because the nucleus can vary and 
the BSC mainline can be broken into 2K segments, the 
storage map shown in Figure 1-2 is only a logical repre- 
sentation of how BSC appears in main storage. 



BSC CSB and I/O Area 



BSC Mainline 



Nucleus 



> User Area 



Figure 1-2. BSC Storage Map 
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(SSP ^ 

common open J 



#BSOB 



Updates DTF with any information specified 
by OVERRIDE procedure. 
Calculates size required for BSC I/O area and 
allocates area from system queue space. 
If switched line IDs were specified via the 
OVERRIDE procedure (or the SETR utility 
control statement), moves switched ID char- 
acters to BSC I/O area. 
Sets DTF to postopen status. 
Sets CSB to postopen status. 
Sets any hardware information in IOB that may 
have been altered by ALTER BSC procedure. 
Displays error messages if invalid DTF informa- 
tion is found. 



Open any more DTFs in chain 



y ssp \ 

V common open J 



Figure 1-3. BSC Open 



User request, put, 
or get 



#BSIW 

• Waits for BSC user requests and microcode 
interrupts (operation ends). 



• Posts #SVTTC for linkage to #BSMD if per- 
manent error has occurred and message is to 
be displayed. 



• Links to interrupt handler to process operation, 
ends. 



• Loads control storage error logging transient 
to create error history table entry. 



♦ If user request, passes control to #BSDBr 



♦ If put EOF, close, or terminate operation code 
in DTF, links to BSC close transient. 



♦ If called to wait on IOB, returns to caller. ■ 



"f #BSHB J 



"*( #BSDB J 

■*( #BSCL J 

"*( Caller J 



Figure 1-4. BSC Wait 



BSC 1-31 



Licensed Material— Property of IBM 



(User request \_ 

via #BSDB /" 



c 



#BSCKRI 



( #BSL2 V 



f #BSL3 J 

( #BSL4 




#BSLO 

• If a phone call is required, sets up the operator 
message. t 



• If the line is not active, loads the BSC micro- 
code and enables the adapter. 



• If the line is not yet enabled and the user has 
specified switched IDs in the DTF, allocates 
space in the system assign/free area and moves 
the switched ID characters into the allocated 
area. 



• Initializes the BSC work area. 



• If the line is active, links to BSC close to close 
the old file. 



• Links to the proper line initialization routine. 



*•• If an error occurred during line initialization, ■* 
calls #BSIO to transmit an NAK, EOT, or DISC 
and calls #BSIW to wait. •* 



Calls #BSPST2 to post #SVTTC, which links to 
BSC message transmit to display an operator - 
message. 



Figure 1-5. Line Initialization Mainline 



Multipoint 



X #BSMLTP ^ 

V via#BSDB J 



Switched Call 



#BSL2 



Switched Answer 



3 



■/ #BSL3 J 



Point-to-Point, Nonswitched 



' *( #BSL4 J 

■/ #BSIO J 



*f #BSIW J 

r('' ; #BSPST2 ) 
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f #BSDB Y 



( #BSHB Y 



( #BSHB Y 



#BSMLTP 

• Calls #BSRI to set up receive-initial operation 
for first file. 

• Waits for address if automatic response is 
running. 

• Checks response to receive-initial operation. 



/ #BSIW J 

/ #BSDB J 



#BSAUTO 

• Sets up IOB and issues SVC for receive-initial 
operation. 

• Sets automatic response flag. 



#BSMPEOT 

• Sends EOT and starts receive-initial operation 
after a permanent error. 



#BSRI 

• Sets up the IOB and issues the SVC for a 
receive-initial operation. 



f #BSHB Y 



#BSCKRI 

• Checks for valid poll or address. 

• Sends EOT or NAK if automatic response. 

• Sends EOT if poll is received and file is a get 
file. 

• Sends RVI if selection is received and file is a 
Put file. 

• Starts receive-initial operation after EOT, NAK, 
or RVI. . 

• Sends ACKO if a valid address was received. 

• Starts 2-second time-out if a valid poll was 
received. 

• Links to #BSLQ if error retry count is 
exhausted after invalid polls, addresses, or 

> line errors. 



( #BSLO J 



Figure 1-6. Multipoint Line Initialization 
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( #BSLO V 



#BSL2 



Sets up IOB and sends (ID) ENQ. 

Checks for correct (ID) ACKO response. 

For put file, sets up the IOB and starts a 

2-second time-out. 

For a get file, sets up the IOB and transmits 

EOT. Sets up so #BSL4 receives control to 

look for ENQ. 

If permanent error occurs, links to #BSL0 to 

disable line and display message. 



*f #BSDB j 

■*( #BSLO J 



Figure 1-7. Switched Call Line Initialization 



( #BSL0 V 



#BSL3 

• Sets up IOB and looks for (ID) ACKO. 

• Sets up IOB and sends (ID) ACKO. 

• For put file: 

- Checks for EOT response to ID (ACKO). 

— Sets up IOB and transmits ENQ. 

- Checks for ACKO. 

— Sets up IOB and starts 2-second time-out. 

• For a get file, sets up IOB and transmits ID 
(ACKO). 

• If permanent error occurs, links to #BSLO to 
disable line and display message. 



"*( #BSDB J 



*f #BSLO J 



Figure 1-8. Switched Answer Line Initialization 



( #BSLO Y 



#BSL4 



For put file: 

— Sets up IOB and transmits ENQ. 

— Checks for ACKO. 

— Sets up IOB and starts 2-second time-out. 
For get file: 

— Sets up IOB and looks for ENQ. 

— Sets up IOB and sends ACKO. 

If permanent error occurs, links to #BSLO to ■ 
disable line and display message. 



#BSDB 



#BSLO 



} 

3 



Figure 1-9. Point-to-Point, Nonswitched Line Initialization 
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( #BSDB \ 



#BSMP 



Goesto#BSIW to wait on the IOB. 

Moves the control characters to the physical 
buffer for the first time for this buffer. 
Goes to #BSIO to transmit the physical buffer 
when it is full. 



If in compression or truncation mode, goes to 
#BSCP. 



Moves the record from the logical buffer to the 

physical buffer (#BSMO). 

Returns to #BSDB 



#BSIW 



#BSIO 



3 



-*/ #BSDB J 



Figure 1-10. Put 



#BSCP 

• When in compression mode, compresses groups 
of two or more blanks. 

• Moves the compressed record, in sections 
(#BSMO). 

• In truncate mode, removes trailing blanks from 
each record. 

• Moves the truncated record to the physical 
buffer (#BSMO). 



#BSDB 
via #BSMP 



) 
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( #BSDB \ 



#BSMG 

• Waits for IOB completion. 



♦ ; Goes, to #BSXP for expansion, or truncation. 



/ #BSIW J 



• Moves data record from physical I/O buffer to 
: user's logical buffer (#BSMO). 

♦ If buffer is complete, goes to #BSIO to receive 
next data block. 



Returns to #BSDB. 



/ #BSIO J 

/ #BSDB J 



#BSXP 



Searches for IGS characters in physical I/O : 
; buffer in expansion mode. 

• If IGS is found, moves parts of records from 
: physical I/O buffer to user's logical buffer 

(#BSMO). 

• Searches for IRS characters and moves record 
to logical buffer for truncation and remainder 
of record for compression (#BSMO). 



Figure 1-11. Get 



(Wait or user ^ 
request (#BSDB) J 



#BSPOST/#BSPST3 

• If user program has been swapped to disk, posts 
#S VTTC to get user into storage. 

• Moves copy of DTF from BSC work area to 
DTF. 

• If RVI received, sets RVI indicator in user 
program. 

• Posts #SVTTC to return control to user 
program . 



Wait, close 
or line initialization 



jtion J 



Figure 1-12. Post 
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#BSPST2 

• Posts #SVTTC. 

• Puts return code for #SVTTC in CSB. 

• Decrements user's swap count. 

• Goes to #BSIW to wait to be posted again by 
#SVTTC. 



/ #BSIW J 
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#BSLOor#BSIW 



> 



#BSCL 



♦ For put file with new file pending: 



— Transmits any outstanding buffers followed 
by STX-ETX or EOT. 

— Sets old file to preopen status. 

— For a multipoint line, starts a receive-initial 
operation. 

For put file with no new file pending: 

— Transmits any outstanding buffers followed 
by EOT or DISC. 

— Sets old file to preopen status. 

— Disables line, logs text and error counters, 
and frees BSC I/O area. 

For get file with new get file pending or new — 

put file and not 3740 mode, sets file to preopen 

status. 

For get file with new put file pending and 3740 

mode: 



-*■[ #BSL0 



-*i Caller 



— Transmits ACK as response to last null 
record and waits for EOT. 

— Sets old file to preopen status. 

For get file with no new file pending and 3740 
mode: 

— Transmits ACK to null and waits for EOT. 

— Sets old file to preopen status. 

— Disables line, logs text and error counters, 
and frees BSC I/O area. 

For get file with no new file pending and not — 
3740 mode: 

— Sets old file to preopen status. 

— Disables line, logs text and error counters, 
and frees BSC I/O area. 



' #BSL0 



#BSL0 



Caller 



Caller 



Figure 1-13. Close 
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( #BSIW Y 



#BSHB 



If requested by user, traces operation ends. 
If line initialization is in process, returns with 
no checking. 

If automatic response in process, checks for ■* — 
valid poll or address. 

Checks for correct response from remote station 
and posts IOB normal or with error code. 
If IOB posted normal, calls #BSIO to start next 
operation if another IOB is ready; otherwise, 
starts 2-second time-out. 

If 2-second time-out, calls #BSIO to start trans- - 
mission of WACK or TTD. 
If IOB is posted with error, checks if retry 
count is exhausted. If not, starts appropriate 
error recovery and returns. If retry count is 
exhausted, builds entry for error history table, 
posts IOB with proper completion code, trans- 
mits EOT to remote station, and returns. 
If multipoint line, starts receive-initial opera- .*- 
tion after sending EOT because of permanent 
error. 

If multipoint line, starts receive-initial opera- 
tion after receiving EOT. •* 



Figure 1-14. Operation End Processing 



Request to 
start I/O 



> 



Figure 1-15. BSC IOS 



#BSIO 



If IOB is already online (other than a 2-second 

time-out), returns to caller with no operation 

started. 

If IOB is already set up, issues SVC and returns. 

Otherwise, sets up IOB for BSC requests, issues 

SVC, and returns. 



f #SVTTC \ 



#BSMD 



Sets up MIC and options in system log 
parameter list. 

If specified, sets user permanent error indicator. 
Issues message via system log and returns 
(unless operator takes 3 option). 



J #BSCKRI J 



/ #BSIO J 

/ #BSIW J 

/ #BSMPEOT J 

J #BSAUTO j 



/ Caller j 



#SVTTC 



D 



Figure 1-16. Message Logging 
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Directory 

This section consists of a quick-reference table that can be 
used to find BSC modules on microfiche program listings. 
The table contains: 

• Module/routine name 

• Diagram number 

• Descriptive name 

• Function 



Module/ 
Routine 
Name 



Diagram 
Number 



Descriptive Name 



Function 



#BSCM 



#BSATR 



1.9 



#BSAUTO 1.2.1 



#BSCKRI 1.2.1 



Resident data management 
(BSC mainline) 

Address translation 



Receive-initial initiator 



Check receive-initial 
command 



Processes all BSC user requests. The following routines 
(#BSATR through #BSXP) are all part of this module. 

Converts user's logical address to BSC logical address and 
updates BSC ATR stack. 

Sets up IOB and issues SVC for receive-initial command. 
Starts automatic response. 

Checks for poll or address response with NAK, EOT, 
ACKO; or starts 2-second time-out. Starts another receive- 
initial command after NAK or EOT. 



#BSCP 



1.5.2 



Blank compression 
and expansion 



Removes blanks and inserts 3780 control characters. 



#BSDB 



t/BSHB 



#BSIO 



#BSIW 



#BSMG 



1.4 


Data management for 




get and put 


1.3.1 


Operation end proces: 


1.6 




1.2.1 


BSC IOS 


1.2.2 




1.2.3 




1.2.4 




1.3.1 


Wait 


1.5.1 




1.7 




1.8 




1.3.2 


Data receive 



Invokes module necessary to receive and/or transmit data. 



Analyzes operation end interrupts and (1 ) gives control to 
error recovery routines, or (2) sets good completion code 
in IOB. 

Sets up IOB and issues SVC to start BSC I/O operations. 



Waits for completion of BSC I/O operations of for user 
requests. 



Deblocks the receive buffer. 



BSC 1-39 



Licensed Material— Property of IBM 



Module/ 

Routine Diagram 

Name Number 



#BSCM (continued) 
#BSMLTP 1.2.1 



#BSMO 



1.3.2.1 



Descriptive Name 



Function 



Multipoint router 
on new file 



love 



#BSMP 


1.4 
1.5.2 


Data blocking 


#BSMPEOT 


1.2.1 


Send EOT 


#BSPOST 


1.4 


Post 



#BSRI 


1.2.1 


Receive-initial initiator 


#BSXP 


1.3.2.1 


Blank expansion 


#BSCL 


1.2 
1.8 
1.10 


Close 


#BSL0 


1.2 
1.4 


Line initialization 


#BSL2 


1.2.2 


Line initialization 


#BSL3 


1.2.3 


Line initialization 


#BSL4 


1.2.2 
1.2.4 


Line initialization 



Sets up receive-initial command if automatic response not 
on or waits for address if automatic response started. 

Moves data from physical buffer to user's logical buffer for 
receive, and from user's logical buffer to physical buffer 
for transmit. 

Blocks the data records. 



Sends EOT and starts receive-initial processing. 

Restores user's DTF, sets RVI indicator if required, and 
posts system task-to-task interface routine (#SVTTC) to 
return to user. 

Sets up IOB and issues SVC for receive-initial command. 

Removes 3780 control characters and inserts blanks. 



#BSMD 



#BSOB 



None 



1.1 



BSC message transient 



Open 



Closes BSC files and terminates BSC task. 

Determines line type and calls appropriate transient. 

Initializes switched-call line. 

Initializes switched-answer line. 

Initializes point-to-point, nonswitched line. 



Sets up parameter list and calls the system logging routine 
to display BSC error messages. Sets permanent-error 
indicator if required (RPG II only). 

Opens BSC files. 
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Data Areas 

BSC uses the following data areas, which are described in 
the Data Areas Handbook : 

• BSCDTF 

• BSC IOB 

• BSCCSB 

• BSC work area 

• BSC I/O area 

• BSC buffers 
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Part 2. MULTI-LEAVING Remote Job Entry (MRJE) Utility 



Introduction 

The IBM System/34 MULTI-LEAVING Remote Job Entry 
(MRJE) SSP utility provides the ability to submit, execute, 
and obtain results of jobs from a host system via the com- 
munications adapter. Host systems are: 

• ASP under OS/VS2 

• HASP II under OS/VS2 

• RES under OS/VS1 

• JES2 under OS/VS2 

• JES3 under OS/VS2 

• VM/370 RSCS 

These host systems support a line discipline (MULTI- 
LEAVING) that permits maximum overlap of I/O opera- 
tions at the remote station and the host system. 

Communication is in EBCDIC and text transparency can 
be used. 

The MRJE utility can run either in attended mode or auto- 
matic mode. For attended mode operation, the operator 
must be present while the MRJE utility is running. For 
automatic mode operation, the operator need not be 
present to handle MRJE halts. 

Input to the host system can be any job that can be 
entered at the host system from similarly functioning 
I/O devices. MRJE input can be entered from the key- 
board, from a disk file, or from a system library member. 

Output from the host system can be returned to the 
MRJE utility, directed to another RJE work station, or 
directed to the host system's I/O devices. Output files 
created by MRJE are sequential files that can be processed 
by customer-written RPG II programs (except TDISK 
files), by customer-written assembler programs (except 
TDISK files), or by the data communications print utility 
($DCSUP). MRJE operator messages received from the 
host system are directed to the system console and 
entered in the history file. 



FUNCTIONAL ORGANIZATION 

Execution of the MRJE utility can be divided into three 
general functional areas: initialization, processing, and 
termination. 



Initialization 

The MRJE utility is loaded by entering the MRJE 
procedure command from the system console. 

During initialization, MRJE performs the following opera- 
tions: 

1. Displays the initialization display at the console. 
The format used can be either the IBM-supplied 
format (#MR01 ) or a user-written format. The 
operator can modify any of the parameters and 
then press the Enter key or simply press the Enter 
key to have MRJE use all default values. 

2. Builds and initializes the following data areas: 

a. The program function control blocks (PFCBs) 
for the tasks performed during MRJE processing. 

b. The communication and control table (CCT) 
containing information on the status of the I/O 
devices, the addresses of the MRJE modules, 
information relating to the printer, task-to-task 
communication information, and other informa- 
tion required by more than one module. 

3. Builds the total MRJE utility and the individual task 
buffers based on the information given on the 
initialization display. 

4. Determines the space remaining in the region allocated 
to the MRJE mainline program. If the space remain- 
ing is large enough for the MRJE BSC module and 
buffers (as specified on the initialization display), 
MRJE loads the BSC open module via system allocate 
and builds the BSC buffers. If the space is not large 
enough, MRJE issues a message to the operator 
indicating that not enough storage is available. 
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6. 



Establishes task-to-task communications between the 
MRJE mainline and the MRJE BSC module. 

Creates termination exit blocks to handle MRJE and 
BSC abnormal termination. 



Processing 

During processing, MRJE performs the following functions: 

• BSC: Transmits and receives data, and maintains 
communications with the host system. 

• Printer: Processes all printer data from the host 
system. The printer data is either printed, written 
to the TDISKPR1 file for standard print forms, or 
written to individual files for special printer forms 
on disk. 

• Console output: Processes MRJE messages and all 
console output from the host system. 

• Console input: Processes MRJE statements and host 
system commands. 

• Reader: Processes MRJE statements and jobs entered 
at the display station for the host system. 

• Punch: Processes all punch data from the host system. 
The punch data is written to individual files on disk. 

Associated with each function is a PFCB, which contains 
control and status information for the task, and an IOB, 
DTF, or TUB address. The PFCBs are chained as shown 
in Figure 2-1. 

Dispatching Logic 

The dispatching supervisor ($MRJE) coordinates all 
MRJE processing by continually monitoring the PFCBs. 
When a PFCB indicates that there is work for the task 
to perform, the dispatching supervisor passes control to 
the dispatching address stored in the PFCB. The dispatch- 
ing address is the address of the routine that receives 
control when the task is dispatched. 



Upon completion of an operation by a task, control is 
returned to the dispatching supervisor. For example, 
after the print task issues a supervisor call (SVC) to start 
an I/O operation, the task sets a bit in the printer PFCB 
indicating that it is waiting for completion of an I/O 
operation. Then, the task returns control to the dispatch- 
ing supervisor. The dispatching supervisor checks the 
remaining PFCBs and TUB for work to be done and 
dispatches the tasks in turn if work is found. When all 
PFCBs have been checked, and no more work can be 
done, the dispatching supervisor issues a wait-on-any 
SVC to return control to the SSP. When an external 
event occurs, such as the completion of an MRJE I/O 
operation, the MRJE dispatcher is posted out of its wait. 
The MRJE dispatcher then identifies the event that 
occurred, posts the appropriate function, and returns 
to its dispatching loop. 



Termination 

During termination, MRJE (1) disables the communica- 
tions adapter, (2) closes the TDISKPR1 file if required, 
(3) displays the BSC statistics for the session, (4) updates 
the BSC I/O counters, (5) terminates the BSC task, and 
(6) terminates the MRJE task. 



INPUT/OUTPUT 

Input required by System/34 MRJE consists of the 
following: 

• Program load data from the MRJE procedure command 
entered at the system console 

• Configuration, carriage, and sign-on information from 
the initialization display 

• MRJE utility control statements 

• Print and punch output data and messages from the 
host system 

• JCL, data, and host system commands entered from 
the System/34 

Output depends on the type of program being run. 
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Figure 2-1. Chain of PFCBs for MRJE 
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SYSTEM INTERFACES 



Hardware Interface 



The System/34 
tasks: 



IRJE utility consists of two main storage 



• The BSC task, which controls the BSC line. The BSC 
task interfaces with the main MRJE task, the BSC con- 
trol storage module, and the BSC hardware. The BSC 
task also controls the flow of data over the BSC line. 

• The main MRJE task, which controls the remainder of 
the MRJE program. The main MRJE task supervises 
the loading and dispatching of the MRJE main storage 
modules that execute in the MRJE-allocated overlay 
areas. The main MRJE task also controls the overall 
flow and scheduling of work within MRJE. 

All of the MRJE main storage modules reside in the system 
library. 



SSP Interfaces 

MRJE operates under control of the System/34 SSP. The 
SSP controls display station data management, allocation 
and deallocation of printer and disk files, task-to-task 
communication, get-page and free-page operations, BSC 
trace, finding and loading of the MRJE main storage 
modules, system log operations, history file put operations, 
and program termination. 

MRJE operates as a stand-alone MRT (multiple requestor 
terminal) program and is also defined as an NEP (never- 
ending program). The main MRJE task is loaded by the 
SSP and runs in its own storage area. The main MRJE 
task uses the system allocate function to start the BSC 
task. The two MRJE tasks then share a common storage 
area. The BSC task is nonswappable and the main MRJE 
task is swappable. The various MRJE modules are loaded 
and run, as needed, in overlay areas that are part of the 
MRJE storage area. 



Control Storage Interface 

The BSC open module (#MRBO) loads the BSC control 
storage microcode. #MRBO loads the microcode using 
the System/34 load control storage transient SVC 
instruction. 



The IOB (input/output block) and System/34 supervisor 
calls (SVCs) provide the interface to the BSC hardware. 
The MRJE BSC task uses transmit/receive operations 
with buffer overlay (TRRCVOL) and, for some special 
operations, uses transmit/receive operations without 
buffer overlay. 



ERROR RECOVERY 
Types of Errors 

MRJE errors can be caused by: 

• System console 

• Display station 

• Disk 

• Printer 

• BSC 

• Operator or programmer 



System Console Errors 

If an error occurs on the system console, MRJE abnormally 
terminates. The communications adapter is disabled and 
the TDISKPR1 file, if one exists, is closed as if the operator 
had selected a 3 option for an error message or a CANCEL 
control command. 



Display Station Errors 

If an error occurs on a display station (other than the 
system console) that is a reader, that reader task is marked 
as having a display station error. Any subsequent messages 
to that display station are logged only to the history file. 
MRJE assumes default responses to halts. When the next 
input statement is to be read from the display station, the 
display station is released and that reader task is terminated. 
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Disk Errors 

A disk write error causes a hard system error (a processor 
check). A disk read error that occurs while the TDISKPR1 
file is being processed causes a message to be displayed and 
the print task to be deactivated. 

A disk read error that occurs while the reader task is reading 
from the disk causes a message to be displayed and the 
reader task to be deactivated. If a disk error occurs while 
putting the BSC I/O counters to disk, a message is displayed 
and the counters are not updated. 



Printer Errors 

When a printer error occurs, and MRJE is in automatic 
mode, the print queue is cleared and quiesced, a message 
is displayed, and the print task is deactivated. If MRJE 
is not in automatic mode, normal SSP error recovery 
occurs. 



BSC Errors 

When a BSC error occurs, the appropriate message is 
displayed and the error is recorded in the PFCB for the 
BSC task. When MRJE terminates, the error counters 
are updated with the information in the BSC PFCB. 



Operator or Programmer Errors 

If the operator keys invalid program load data when starting 
MRJE, an appropriate message is displayed and MRJE 
terminates. If the operator keys invalid data into the 
initialization display, the fields in error are redisplayed in 
reverse image, the audible alarm is sounded, and an error 
message is displayed. The operator can then enter the 
correct field values or change any of the original values. 



If an error is found in an MRJE utility control statement, 
one of the following occurs: 

• If the statement in error was entered from the keyboard, 
an appropriate error message is displayed and execution 
continues. The operator can then enter the correct 
statement or any other statement. 

• If the statement in error was read from a disk file, an 
appropriate error message that allows a or 1 option 
is displayed. If the operator selects a option, the 
statement in error is ignored and execution continues 
with input from the disk file. If the operator selects 

a 1 option, the keyboard is unlocked and the operator 
can then key in the corrected statement. After the 
new statement is processed, execution continues with 
input from the disk file. 



SYSTEM REQUIREMENTS 

MRJE operates in the user program area under control of 
the System Support Program Product (SSP) and requires 
supervisor and input/output supervisor (IOS) services 
provided by the SSP. 

The minimum system configuration required to support 
MRJE is: 

• 16K region size 

• Communications adapter 

• EBCDIC capability specified 

A region size greater than the minimum required allows 
more tasks (punch and additional readers), allows full 
compression, and can improve performance by increasing 
the number of BSC buffers. 
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Method of Operation 

This section contains the logical functions of MRJE using 
an overview (see Diagram 2) and an input-process-output 
diagram for each function. 

For detailed information on input-process-output diagrams, 
see Diagram Techniques in How to Use This Manual at the 
front of this publication. 



INPUT 



Data to and from . 
the host system 

OS/370 job stream 



Output data _ 
from the host 
system 

Operator-entered 
records 



Console data ~ 
from host 
system or local 
messages 

END utility ~ 
control statement 
or user cancel 



Diagram 2. MRJE Overview 




PROCESS 



Initialization (2.1). 



I f 



I I 



WM Processing (2.2). 
[^> • BSC processing (2.2.1). 



~_^- • Reader input (2.2.2) 



I I 



^^ • Printer and punch output (2.2.3). 



~_^ • Console input (2.2.4). 



^> • Console output (2.2.5). 



> 



Termination (2.3). 



OUTPUT 



^> MRJE control 
blocks 



I I 



]^> Data to and from 
the host system 



^^ Host system job 
stream and 
utility control 
statements 
processed 



I I 



~^ Printer or disk 
output 



^> Data for the 
host system 
and utility 
control state- 
ments processed 



~^> Messages on the 
display screen 



_^ End of job 
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From: Program Initiation 



INPUT 



c 



PFCBs 

XR1 

CCT 

Host system sign- 
on command 




PROCESS 



> 



Initializes the following: 

• PFCBs for the BSC, reader, printer, 
console input, and console output 
tasks. 

• Temporary configuration table. 

• CCT. 

Creates PFCBs (for the punch and second 
and third reader tasks) and buffers, if 
required. 

Establishes communications with the host 
system. 



£> 




OUTPUT 



c 



c 



PFCBs 

Temporary con- 
figuration table 

XR1 

CCT 

PFCBs 

I/O buffers 

CCT 

BSC buffers 



To: MRJE Processing, 2.2 



DESCRIPTION 



MODULE/ 
ROUTINE 



Reads the initialization display from the system console and uses it to complete the fields in the control blocks 

• Loads and initializes the buffer manager (#MRBM) and, if required, the full compression routine (#MRFC). 

• Divides the remaining main storage region into transient areas; I/O buffers for the processors; BSC buffers; 
and PFCBs, DTFs, and lOBs for the additional reader and punch functions. 

• Chains the BSC buffers and places the address of the first BSC buffer in the CCT. 

To establish communications, the operator dials the host system if dialing is required. MRJE then sends a sign- 
on command (entered from the system console initialization display) to the host system. BSC open (#MRBO) 
sets up to send the sign-on command, while the BSC I/O processor (#MRBP) actually sends the command. 



#MRI1 



#MRI6 



#MRBO 
#MRBP 



Diagram 2.1 Initialization 
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From: Initialization, 2.1 



r 



INPUT! 



BSC buffer con- 
taining data to be 
transmitted to 
the host system 

or 
Data received 
from the host 
system 

Job stream 
entered from the 
keyboard or the 
disk 



Output data 
received from the 
host system 



Record entered 
from the keyboard 

Local message 
in the message 
queue 

or 

Console message 
received from the 
host system 





m PROCESS 
jo>fcl BSC processing (2.2.1).' 



i r 



OUTPUT 




J5>H Reader input (2.2.2). 



> 



Printer and punch output (2.2.3). 



> 



> 



Console input (2.2.4). 



^>H Console output (2.2.5). 



:> 



Data transmitted 
to the host system 

or 
BSC buffer contain- 
ing data received 
from the host 
system 



Data transmitted 
to the host system 

and 
MRJE utility con- 
trol statements 
processed 

Printer output 
written to disk or 
printed 

or 
Punch output 
written to disk 

Data transmitted 
to the host system 

or 
MRJE utility con- 
trol statements 
processed 



^^ Displayed 
message 




To: Termination, 2.3 



DESCRIPTION 


MODULE/ 
ROUTINE 


The following functions are performed, as required, during MRJE processing: 
Q BSC processing. 
WM Reader input. 

|£] Printer and punch output. 

£J Console input. 
H Console output. 


#MRBP 


#MRRP, 
#MRKP, or 
#MRFR 


#MRDPor 
#MRUP 


#MRCP 


#MRCDor 
#MRHD 



Diagram 2.2. MRJE Processing 
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INPUT 



From: MRJE Processing, 2.2 

PROCESS 




I 



OUTPUT 



BSC buffer 
containing data 
to be transmitted 



Data received 
from the host 
system 



Starts a transmit operation and waits for a 
hardware interrupt. 



^>|3 When a hardware interrupt occurs, starts a 
receive operation. 



Posts #MRBP complete. 



BSC buffer con- 
taining data 
received 



If an error is detected or an NAK is 
received, logs an error message and 
processes the operator's response. 



^>|jj Queues the received buffer to the 
processor PFCB. 



^> Data transmitted 
to the host system 



^> BSC buffer con- 
taining data 
received 



> 



BSC PFCB 



|^> Logged error 
message 



> 



Processor PFCB 



Restarts a transmit operation. 



£> BSC buffer 




To: MRJE Processing, 2.2 



Diagram 2.2.1. BSC Processing 



DESCRIPTION 


MODULE/ 
ROUTINE 


| After #MRBP receives control via a BSC I/O post, it determines if there is data to send to the host system or 


#MRBP 


if the host system is transmitting text. In either case, a BSC transmit operation is started. If there is no data 




to send to the host system and the host system is not transmitting text, #MRBP starts a 2-second time-out 




operation; on completion of the time-out operation, a transmit operation is started. 




£J On completion of the BSC transmit operation, control is given to the interrupt portion of #MRBP (BSCAIL). 




The interrupt portion starts a BSC receive operation. 




B<1 On completion of the BSC receive operation, the interrupt portion posts the mainline portion of #MRBP 




complete. 
£J If there are errors, or if an NAK is received, control is passed to the BSC error recording routine (#MRBE) to log 




#MRBE 


an error message and to process the operator's response. If the operator responds by selecting a 2 option. 




control is passed to the terminator (#MRTM) through the MRJE dispatcher. 
Q The received BSC buffer is inspected for text received. If text was received, #MRBP queues the BSC buffer to 




#MRBP 


the PFCB determined by the record control byte. 




Jlj A BSC transmit operation is restarted, repeating Steps 1 through 5. 
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■ INPUT 



From: MRJE Processing, 2.2 

■i PROCESS 



VTOC format 1's 
PFCB for reader | 

Job stream from 
keyboard or disk 

Display station 
DTF 

Reader PFCB 

CCT 

Reader PFCB 



Input buffer 



BSC buffer 



EOF statement 
in job stream 

or 
Physical EOF on 
disk 




-j^'H If the job input is from the keyboard, 

issues the reader input format. If the job 
input is from disk, sets up to read the disk 
file (2.2.2.1). 



f 



OUTPUT 



"^>E1 Reads input (2.2.2.2). 



=1": 

L2" 



isk IOB 



splay station 
DTF 



1 J> H 

_ V ^>(5J If data from keyboard is entered using 

command key 1, console input is activated 
to process the data. 



Z^KJ Processes any utility control statements 
found in command files (2.2.2.3). 




I 



"^ Input buffer 



> 



Reader PFCB 
CCT 



I I 



^> H Prepares records to be transmitted to the 






■ i host system 
l^*H Transmits data. 

I | 

^>Q Closes (2.2.2.4). 



CCT 
PFCBs 
£> BSC buffer 



J L 

^ > Data transmitted 
I I to the host system 




i^> Reader PFCB 



To: MRJE Processing, 2.2 



DESCRIPTION 



MODULE/ 
ROUTINE 



This operation is performed under the logical reader input task/ Reader input from the keyboard is invoked by the 
MODIFY utility control statement or during initialization. Reader input from disk is invoked by the READFILE 
utility control statement or during initialization. 

Q * If input is from the keyboard, displays the reader input format. 

• If input is from disk, the open function ensures the readiness of the file or library member to be read. Checks 
disk file labels to ensure that the proper files are available and that the attributes of the data (for example, 
record length) are valid for reader input. 

3 Places the input entered from the keyboard or disk into the reader input buffer. 



If keyboard input and the DTF indicates command key 1, activates the console input task through the reader 
task. The reader task is temporarily halted. 



#MRKP 



#MRRO 



#MRKP, 
#MRRP, or 
#MRFR 



#MRKP 



Diagram 2.2.2 (Part 1 of 2). Reader Input 
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DESCRIPTION 



MODULE/ 
ROUTINE 



If input is from the command file, scans the input for utility control statements. If a utility control statement is 
found, invokes the command processor (#MRCO) to process it. 



Prepares records to be sent to the host system for transmission by compressing duplicate characters (if 
compression was requested) and by truncating trailing blanks and adding appropriate control information to the 
records. Then, places the records into the BSC buffer. 

When the BSC buffer is full, transmits the buffer to the host system. 

Upon detection of an EOF utility control statement or a physical end of file on disk, closes the job input 
operation. Sends a logical end of file to the host system and updates the PFCB to indicate the closing of the 
reader task. 



#MRRP, 
#MRFR, 
#MRKP, and 
#MRCO 



#MRRP, 
#MRFR, 
#MRBM,and 
#MRFC 



#MRBPand 
#MRBM 



#MRRP, 

#MRFR,and 

#MRRC 



Diagram 2.2.2 (Part 2 of 2). Reader Input 
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INPUT 



From: MRJE Processing, 2.2 

m PROCESS 




PFCB for reader 
input task 



_ | ^>m Checks if any previous disk or keyboard 
reader input operation is active. If yes, 
saves the status of the previous reader 
operation. 



f 



OUTPUT 



^> PFCB for reader 
input task 



Assign/free area 



>H 



Builds an IOB, DTF, or source get 
parameter list. 

Verifies file name and attributes. 



=> 



Sends an RFT sequence to the host system 




BSC buffer 
containing GFT 
sequence 



^>J2| Waits for GFT sequence from the host 
system. 



Invokes the reader input processor. 




IOB 

DTF 
Parameter list 



^> BSC buffer con- 
taining the RFT 
sequence 



To: Reader Input Processing, 2.2.2.2 



DESCRIPTION 



MODULE/ 
ROUTINE 



Checks the reader input PFCB to determine if a previous command file is being read. If so, saves the status of 
the file. 

Creates an IOB, DTF, or source get parameter list to be used by the reader input processor (#MRRP, #MRFR, 
or#MRKP). 



Issues a message to indicate the reader is activated. 



#MRRC 



#MRRO 



#MRRO 



Diagram 2.2.2.1. Input Open Processing 
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■ INPUT 



From: Input Open Processing, 2.2.2.1 

PROCESS 



IOB/DTF 



I/O buffer con- 
taining input 
record 




EOF utility con 
trol statement 

or 
Physical end of 
file 



Issues an IOB, DTF, or source get call 
for a read request. 



Waits for I/O completion. 

V ^'^J If input is from a command file, determines 
if a utility control statement was entered. 
If so, processes the utility control state- 
ment (2.2.2.3). 

Queues the input records for transmission. 



If an EOF utility control statement or a 
physical end of file is detected, sends a 
logical EOF to the host system. 



~^^J«J Schedules the reader close routine 
(#MRRC). 



f 



OUTPUT 



•*^> I/O buffer con- 
taining input 
record 



I I 



^> BSC buffer 
containing 
input records 



I I 



]^> BSC buffer 

containing logical 
EOF 



^> PFCB for reader 
input task 




To: Input Close Processing, 2.2.2.4 



DESCRIPTION 



MODULE/ 
ROUTINE 



Issues an I/O request for the next block of data. 



For disk input, blocks/deblocks the records into 80-byte physical records upon completion of the read operation. 

If command file is specified, scans the whole file for utility control statements; if utility control statements are 
found, passes control to the command processor (#MRCO). 

Compresses and/or truncates the record and inserts it into the BSC buffer. 



Repeats Steps 1 through 4 until an EOF utility control statement is entered or a physical end of file is 
encountered. When either of these conditions exists, sends a logical end of file to the host system. If the reader 
was the last active data stream and an END statement had been entered previously, the interval timer is started 
with the delay value specified in the END statement. 



#MRRP, 
#MRKP, or 
#MRFR 



#MRRPor 
#MRFR 



#MRCO 



#MRBM 
#MRFC 



#MRRC 



Diagram 2.2.2.2. Reader Input Processing 
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INPUT 



Reader Input Processing, 2.2.2.2 
From: or 

Console Input, 2.2.4 

■i PROCESS 




I/O buffer con- _ 
taining utility 
control statement 



x 



CANCEL 
READFILE 

MODIFY 

CARRIAGE 

END 

EOF 



Identifies and validates the statement. 



Processes the statement as follows: 
• Cancels the requested function. 



I I 



> 

Z^> • Updates the reader task PFCB; indicates 
READFILE pending. 



OUTPUT 



I 



I I 



"^ • Updates processor PFCB status. 
^^- • Updates CCT carriage information. 



I I 



^> PFCB 

^> Reader PFCB 



^> PFCB 
O CCT 



Processes the delay parameter. When 

the delay time expires, sends logoff/ 

signoff command to the host system. 



^> • Sends a logical end of file to the host 
system. 



I I 



]£> BSC buffer con- 
taining the logoff/ 
signoff command 




^> Reader PFCB 



Reader Input Processing, 2.2.2.2 
To: or 

Console Input, 2.2.4 



DESCRIPTION 



MODULE/ 
ROUTINE 



#MRCO 



Scans the utility control statement for the keyword and processes it further (by other routines) as follows: 



#MRCOand 
#MRCS 



Processes the CANCEL statement by terminating the specified function. 

Processes the READFILE statement by updating the reader input PFCB. 

Processes the MODIFY statement by updating the correct PFCB. 

Processes the CARRIAGE statement by updating the CCT. 

Processes the END command by saving the delay value. When the printer, punch, and reader data streams 

close, sets the interval timer. When the delay time expires, sends the logoff/signoff command to the host 

system. Any time a print or punch data stream begins, the timer is canceled and reset when all data streams 

are closed. 



#MRCO 



#MRRF 



#MRMO 



#MRCR 



#MRCO 
#MRKP 
#MROP 



Diagram 2.2.2.3. Utility Control Statement Processing 
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p INPUT 



From: Reader Input Processing, 2.2.2.2 
m PROCESS 



PFCB for reader 
task 




> 



Indicates the reader file is closed. 



For a data file, checks if any previous 
command file is pending. If yes, resumes 
processing of the pending command file 
(2.2.2.2). 

If no previous command file is pending, 
sets up the PFCB for the next input 
device to be opened and invokes the 
reader close routine (#MRRC). 



£> 




OUTPUT 



PFCB for reader 
task 



To: MRJE Processing, 2.2 



DESCRIPTION 



MODULE/ 
ROUTINE 



Updates the PFCB to indicate that the reader file is closed. 

If a previous command file is pending, resumes processing the previous command file. If the previous command 
file is from disk, then rebuilds the disk IOB and goes to the reader disk input processor. If the previous command 
file is from keyboard, then goes to the keyboard reader processor (#MRKP). 

If no previous command file is pending, sends a logical end of file to the host system and sets the dispatching 
address in the PFCB to the address of the reader close routine. If the reader was the last active data stream and 
an END statement had been entered previously, the interval timer is set with the delay value specified on the 
END statement. 



#MRRC 



Diagram 2.2.2.4. Input Close Processing 
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INPUT 



From: MRJE Processing, 2.2 

m PROCESS 




DTF 
IOB 
PFCB 
BSC buffer 



1™ 

^>U Allocates the output file (2.2.3.1 ). 
^>|3 Performs I/O processing (2.2.3.2). 



f 



OUTPUT 



Deallocates the output file (2.2.3.3). 



Repeats Steps 1 through 3 until 
termination of the output task is 
requested. 



C> iob 




Output on disk 

or 
Printed output 




To: MRJE Processing, 2.2 



DESCRIPTION 



MODULE/ 
ROUTINE 



Job output consists of processing printer and punch data streams sent by the host system. Processing is performed 
under the printer and punch PFCBs. 

Q Job output begins with the open function which: 

• Allocates the printer or a disk file. 

• Builds an IOB. 

• Waits for an R FT sequence from the host system. 

• Sends a GFT sequence to the host system on receipt of the RFT sequence. 

• Exits to the proper device I/O module. , 

3 As data is received from the host system, decompresses data unless it is going to the TDISKPR1 file (removes 
embedded control characters and puts the data in a readable form). Writes the data to the assigned device. The 
decompression/write cycle continues until a logical end-of-file sequence is received from the host system. 

£J When an EOF condition occurs, the close routine (#MRCL) updates the PFCB to indicate that the printer/punch 
function is closed and that the assigned device/file is closed. If output was to disk, deallocates the file unless the 
output was to TDISKPR1 . 



#MROP, 
#MROD, and 
#MRBM 



#MRBMand 

#MRDPor 

#MRUP 



#MRCL 



Diagram 2.2.3. Printer and Punch Output 
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INPUT 



From: MRJE Processing, 2.2 

■i PROCESS 



PFCB 
BSCb 



uffer I 



CCT 



AFA format 1 
VTOC 




£._. -...— 



Processes the forms mount message from 
the host system if received. 



Waits for the RFT sequence from the 
host system. 



^>m Cancels the delay timer if required. 



Sends the GFT sequence to the host 
system. 



>o 



Builds the IOB. 



Invokes the device I/O module. 



OUTPUT 




To: Output Processing, 2.2.3.2 



DESCRIPTION 



MODULE/ 
ROUTINE 



Processes the forms mount messages from the host system to ensure that the correct forms are mounted or that 
the data is going to be written to disk. 



If an END statement had been entered previously, cancels the interval timer. 



Builds the IOB and any other required control blocks (in the work area). 

Dispatches the correct output processor (#MRDP for disk output or #MRUP for printer output) by setting the 
dispatching address in the PFCB to the address of the processor. 



#MROPand 
#MROD 



#MRDPand 
#MRUP 



Diagram 2.2.3.1. Output Open Processing 
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From: Output Open Processing, 2.2.3.1 

■ INPUThhmhim ■ m PROCESS 




C CB 



^> U Decompresses records from the BSC ' 
^ buffer into the processor buffer. 



f 



OUTPUT 



BSC buffer 



IOB. 



c 



PFCB 



I J 



^> Q Issues an IOB write request. 



Z>/ PFCB 



Processor I/O 
buffer 



^^"H Waits f° r '/O completion. 



Processor I/O 
buffer 



PFCB 



]^> [| Invokes the close processor on receipt 
I of a logical end of file. 



^> Output on disk 
or 
Printed output 



l|]>PFCB 




To: Output Close Processing, 2.2.3.3 



DESCRIPTION 



MODULE/ 
ROUTINE 



Receives and decompresses the next record. 
Writes the record to the current device. 



Repeats Steps 1 through 3 until a logical end of file is received from the host system. When a logical end of file 
is received, the I/O processor sets the dispatching address in the PFCB to the address of the close routine (#MRCL). 



#MRBM 



#MRDPor 
#MRUP 



Diagram 2.2.3.2 Output Processing 
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INPUT 



From: MRJE Processing, 2.2 

m PROCESS 




PFCBfor ~ 
printer or punch 
task 



_^-|^ Indicates that the output file is closed. 



f 



OUTPUT 



DTF 



_^> Q Deallocates any disk files except TDISKPR1 . [ ^>DTF 



£>PFCB for printer 
or punch task 



Deallocates the printer if the printer was 
being used for output. 



CCT 



^^ hJ Starts interval timer if required. 



Sets up the PFCB for the next output 
device to be opened and invokes the 
device open routine. 




^> Interval timer 



To: MRJE Processing, 2.2 



DESCRIPTION 



MODULE/ 
ROUTINE 



Updates the PFCi to indicate that the output file is closed and performs all cleanup processing. 



#MRCL 



If the output file was the last active data stream and an END statement had been entered previously, the system 
interval timer is started using the delay value specified on the END statement. 

Updates the PFCB for the next device to be used (the device specified on the MODIFY utility control statement) 
and sets the dispatching address in the PFCB to the address of the open routine (#MROP). 



Diagram 2.2.3.3. Output Close Processing 
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INPUT 



From: MRJE Processing, 2.2 

PROCESS 



CCT 



( 




f 



OUTPUT 



Checks for console input request from 
reader 1 task. 



Reader 1 PFCB 

Input buffer 

Record entered 
from keyboard 



PFCB 



I/O buffer 



BSC birffer . 



Reads the input record. 



^^ Console input 



If the input record is blank, exits; otherwise, 
logs the record to the history file. 

If the input record is a utility controj 

statement, processes it (2.2.2.3). . 



^PFCB 
^•Input buffer 
^►PFCB 



If the input record is not a utility control 
statement, prepares the record for trans- 
mission. 



_ v ^>' Qj If the input record is not a utility control 
statement, transmits the record to the 
host system. 



I I 



I |_PFCBs 
£> BSC buffer 



~^> Record sent to 
the host system 




To: MRJE Processing, 2.2 



DESCRIPTION 



MODULE/ 
ROUTINE 



The dispatcher invokes the console input processor when the system console is not being used by the keyboard 
reader input function and is not being used for a message response. 

Q If a reader console input request is pending and not processed, checks the reader 1 input buffer. If blank, 
normal console input proceeds; otherwise, copies the reader buffer to the console buffer and processes it. 
If a reader console input request is pending and processed, posts the reader 1 task, suspends console input 
processing, and exits. 

3 Reads the input record and checks to determine if it is a utility control statement. 

gj Blank records are ignored; all others are logged to the history file. 

Q Decodes the utility control statement and takes the correct action. 



#MRCP 



#MRCO, 
#MRCS, and 
either #MRCR, 
#MRRF, or 
#MRMO 



If the input record is not a utility control statement, the console input processor compresses the record and 
inserts it into the BSC buffer. 

Transmits this buffer to the host system. 



#MRBMand 
#MRFC 



Diagram 2.2.4. Console Input 
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From: MRJE Processing, 2.2 




PROCESS 



Displays local messages (WTO or WTOR). 



[ 



OUTPUT 



Acquires the display screen (WTOR). 

Gets operator response and logs the 
response to the history file (WTOR). 

Frees the display screen (WTOR). 

Posts the task that issued the message 
(WTOR or WTO with wait). 



Processes messages from the host system. 



^> Displayed 
message 



PFCB for task 
that issued 
the message 






^> PFCB for task 
that issued the 




> 



message 

Displayed message 

PFCB for printer 
or punch task 



To: MRJE Processing, 2.2 



DESCRIPTION 



MODULE/ 
ROUTINE 



• Retrieves the message request element from the message queue. 

• Fetches the message text from the message member. 

• Displays the message and logs the message to the history file. 

| Because the display screen might already be in use by the console input or reader task, the display screen must 
be acquired to request the operator response. 

Displays a message that requests a reply to the local message. The operator response is checked to ensure that a 
valid option was selected. If the response is not valid, redisplays the message requesting a reply along with an 
error message until a valid response is entered. Logs the valid response to the history file. 

Frees the display screen for use by any other functions requiring operator input. 

Posts the task (PFCB) under which the message was generated, if required. 

Note: A WTO with wait is a message that does not require an operator response, but does suspend the function 
until the message is displayed to the operator. 

• Decompresses the message and scans for a mount message. 

• Processes the mount message, if found. 

• Displays the message. 



#MRCD 



#MRBM and 
#MRHD 



Diagram 2.2.5. Console Output 
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■INPUT 



From: MRJE Processing, 2.2 

p PROCESS 



PFCBs for the 
BSC task, the 
printer task, the 
punch task, the 
reader task, the 
console input 
task, and the 
console output 
task 




> 



Disables the communications adapter. 

Closes the TDISKPR1 file if one was 
allocated. 

Displays the BSC statistics on the display 
screen. 

Updates the BSC I/O counters on disk. 

Terminates the BSC task. 

Terminates the MRJE utility. 



> 




OUTPUT 



Displayed BSC 
statistics 

BSC I/O counters 

TDISKPR1 file 
is closed 



To: Control Storage Termination 



DESCRIPTION 



MODULE/ 
ROUTINE 



Termination of the MRJE session is caused by one of the following: 

• The successful transmission of a logoff/signoff command to the host system and the completion of all functions. 

• A 2 option chosen in response to a BSC disconnect message. 

• A system CANCEL. 

• A processor check in the MRJE or BSC task, or a permanent I/O error on the system console. 

• A 2 or 3 option taken during an inquiry request from the system console. 

Q Determines if the communications adapter is disabled. If not, issues an adapter disable instruction. 



Converts the BSC line statistics in the BSC PFCB to EDCDIC, displays them on the display screen, and logs them 
to the history file. 



The BSC task is posted and goes to end of job. 



Urn The MRJE dispatcher goes to end of job. 



$MRJE, 

#MRTM,and 

#MRBP 



#MRJEand 
#MRBP 



$MRJE 



Diagram 2.3. Termination 
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Program Organization 

This section includes: 

• A storage map indicating the layout of the program 

• A description of each module within the program 

• A description of the control flow between the modules 



MRJE STORAGE MAP 

Figure 2-2 shows the main storage layout of the MRJE 
utility. 



From Assign/Free Area 
|MRJECCT 147 Bytes] 



MRJE BSC Task 
Nonswappable 



2K- 



4K- 



MRJE 

BSC Processor 

and 

Interrupt Handler 



BSC PFCB 



MRJE BSC Buffers 
(minimum of 200 
bytes each) 



Logical 
Address 

-5000 



■5CE0 



• 6000 



Notes: 

1. As the number of functions 
increases, the swappable 
area grows from 12K to a 
maximum of 20K. 

2. As BSC buffers grow from 
200 to 4,096, the non- 
swappable area could grow 
from 4K to 35K. 

3. Total MRJE package equals 
nonswappable area plus 
swappable area. 

4. Minimum BSC buffers 
required equals number of 
print, punch, and reader 
tasks plus 2. 



Figure 2-2. MRJE Storage Map 



MRJE Task 



2K- 



4*- ^^^^^ 



6K- 



8K- 



10K- 



12K- 



14K- 



16K- 



18K- 



20K- 



CCT Address 



MRJE Dispatcher 



BSC DTF 



Console In PFCB 



Printer PFCB IOB 



Reader 1 PFCB IOB 



Console Out PFCB Console Out Buffer | Console Out Msg Queue Display Station DTF 



Console In Buffer 



Display Station DTF 



I Display 



Station DTF | Dispatcher DTF|MRJE Initialization Code 



Overlay Area I 
Console In/Reader 1 



Reader 1 Buffer 



Overlay Area 2 
Console Out/BSC 



Overlay Area 3 
Printer 



Print Buffer 



Buffer Manager 



Full Compression 



Overlay Area Punch 



Punch Buffer 



Punch PFCB 



Overlay Area 
Reader 2 



Reader 2 Buffer 



Reader 2 PFCB 



IOB 



Reader 2 DTF [ 
Overlay Area 
Reader 3 _ 



Buffer 



Reader 3 



Reader 3 PFCB Reader 3 DTF 



Reader 3 PFCB | IOB 



■1600 
■ 1800 



12K 

fixed area 

^ of storage 

regardless of 

functions 



■1E00 



■2400 
■2600 



-3000 



This 8K area 
will be used 
as additional 
functions are 
used. If some 
are not used, 
the other 
areas move 
up accordingly. 
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CONTROL FLOW DIAGRAMS 

Figures 2-3 through 2-9 are control flow diagrams that 
describe each module within the program and the control 
flow between the modules. A bullet (•) indicates a 
process step and a diamond (♦) indicates a decision. 



Cmrje ^ 
loaded / 















#MRI1 

• Reads and verifies data from console. 






• Initialization code controls execution 
of #MRI1 and#MRI6. 

• Gives control to dispatcher when 
initialization is complete. 












* 




















' 












( MRJE dispatcher j 








#MRI6 

* Builds and allocates storage areas. 

* Allocates and starts BSC task. 
















































#MRBP 




iPMRBO 

• Activates the line. 
















• Initialization code prepares to activate line. 











Figure 2-3. MRJE Initialization 
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SSP after 
wait-on-any 



} 



MRJE Event Complete Processor ($MRJE) 

♦ If the BSC routine has posted the dispatcher, 
sets off the waiting-on-l/O indicator in the 
BSCPFCB. 



[ Initialization ] 



If the delay time expires, posts the reader 
task to begin termination. — 
For test-and-set failure, if any TUBs are on 
the vertical queue, locks them there and 
posts the corresponding task. Otherwise, 
issues another wait-on-any SVC. 



If the completed event is an unknown 

display station TUB, creates a new reader 

task, if possible, and posts it. 

If the completed event is a known display 

station TUB, processes the TUB as a 

display station request. 

Otherwise, finds the PFCB that issued the 

IOB and turns off the waiting-on-l/O 

indicator. 



MRJE Dispatcher ($MRJE) 



Gets first PFCB in chain. 



If the PFCB is dispatchable, gives control to 

the appropriate function. 

Gets next PFCB in chain. 

If at the end of the PFCB chain and other 

PFCBs are not completed, 

Issues wait-on-any SVC. 



Exit via 
wait-on-any 



) 



Figure 2-4. MRJE Mainline 



'. . M RDI-K (con- ^ 
sole input) or MRJE 
(display station) J 



#MRKP 

• Sends RFT and waits for G FT. 

• If . . ti is in the first three positions of the 
input record, calls #MRCO (utility control 
statement processor). 

• Transmits the data to the host system via 
a put to #MRBM, one input record at a 
time. 



Figure 2-5. Reader (Display Station) 



Exit via . . EOF 
or physical EOF 
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( E0,er ) 



#MRRO 

♦ If input is from a disk file, allocates the file. 

♦ If input is from a library member, checks for 
existence and length. 

♦ If input is bad, uses reader input for retry. 



#MRRP 

♦ If a data file is to be read, calls #MRFR. - 

♦ If . . M> is in the first three positions of the 
input record, calls #MRCO (utility control 
statement processor). 

♦ Reads the data and transmits it to the host 
system via a put to #MRBM. 



#MRFR 



Reads data via disk IOS and blocks it into 

80-byte records. 

If . . \b is in the first three positions of the 

input record, calls #MRCO. 

Reads data and transmits it to the host 

system via a put to #MRBM. 



#MRRC 

♦ If . . EOF or physical end of file, deactivates 
the reader. 

• Processes end of file, depending on the file 
type. 



Dispatcher 



Figure 2-6. Reader (Disk) 



Enter via 
dispatcher 



) 



#MRCP 



• Gets a record from the system console or, if a 
reader console input request is pending, from 
the reader 1 task input buffer. 
If the record is blank, discards it; otherwise, 
logs the record to the history file. 
If the first three positions of the input record 
are not . . \t>, transmits the record to the host 
system via a put to #MRBM. 
If a MODIFY, CARRIAGE, or REA,DFILE 
statement is read, calls #MRCS. 
If an EOF, END, or CANCEL statement is 
read, calls #MRCO. 

Otherwise, issues an error message for the 
incorrect control statement. 



Exit after 
one record 



) 



Figure 2-7. Console Input 
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#MRUP 



Gets a record from #MRBM and puts the 

record to the printer. 

If an EOF is received from #MRBM, calls 

#MRCL. 



#MRDP 



Gets a record from #MRBM and writes it to 
disk. If TDISKPR1 , the records are blocked 
into 256-byte records. 
If EOF, calls #MRCL. 



f Enter V- 



#MROP 



If a printer, allocates printer and calls #MRUP. 

If a disk, special allocates the file and calls — 

#MRDP. 

If no room to allocate, calls #MRCL. 



#MRCL 

♦ If terminating, sends EOF to the host system. 

♦ If the printer is active, deallocates the printer. 

♦ If the disk, deallocates a special forms file. 



Dispatcher 



Figure 2-8. Disk or Printer Output 
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Reader 
input 



> 



Console 
input 



#MRCO 

♦ If . . EOF from the reader, sends EOF sequence 
to host system via a put EOF to #MRBM. 

♦ If . . END from the reader, treats it as a 
comment, unless automatic mode. If auto- 
matic mode, sends logoff to the host system 
after delay time expires. 

♦ If . . END from the console, sends logoff to the 
host system after delay time expires. 

♦ If . . CANCEL from the console, marks the 
corresponding function as being cancelled. 

♦ If other MRJE control statements, calls #MRCS. 



#MRCS 

♦ If READFILE statement, 

♦ If MODIFY statement, 

♦ If CARRIAGE statement, 



#MRRF 

• Processes READFILE statement. 



#MRMO 

• Processes MODIFY statement. 



Dispatcher 



#MRCR 

• Processes CARRIAGE statement. 



") 



Figure 2-9. Utility Control Statement Processor 
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Directory 

This section consists of a quick-reference table that can be 
used to find MRJE modules on microfiche program listings. 
The table contains: 

• Module name 

• Diagram number 

• Descriptive name 

• Function 



Module 
Name 



Diagram 
Number 



Descriptive Name 



Function 



$MRJE 



#MRBE 



#MRBM 



Dispatching supervisor 



2.2.1 


BSC error recording 




routine 


2.2.2 


Buffer manager 


2.2.3 




2.2.4 




2.2.5 





Dispatches control to tasks whose PFCBs indicate they 
have work to do. Also processes waits and posts. 

Uses system logging to handle BSC errors. 



Manages the BSC buffers by performing moves, puts, 
gets, and purges as required. 



#MRBO 



#MRBP 



#MRCD 



#MRCL 



#MRCO 



2.1 



BSC open 



2.2 
2.2.1 


BSC I/O processor 


2.2 
2.2.5 


Console output 
processor 


2.2.3 


Printer/punch close 
routine 


2.2.2 
2.2.4 


Utility control statement 
processor 



Establishes communications with the host system and 
sets up to send sign-on command. 

BSC mainline I/O processor and interrupt handler. 



Controls all informational and operator reply messages. 



Closes all disk files except for TDISKPR1, or 
deallocates the printer. Sets up the PFCB for the 
next device to be opened. 

Processes MRJE utility control statements. 



#MRCP 



2.2 



Console input processor 



Processes all information entered for the console input 
task. 



#MRCR 



#MRCS 



2.2.2.3 


CARRIAGE utility 


2.2.4 


control statement 




processor 


2.2.2.3 


Utility control statement 


2.2.4 


scanner 


2.2.5 





Processes the CARRIAGE utility control statement. 



Scans a utility control statement and invokes the 
appropriate processor. 
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Module 
Name 



Diagram 
Number 



Descriptive Name 



Function 



#MRDP 



2.2 
2.2.3 



Disk output processor Processes all MRJE disk output. 



#MRFC 



#MRFR 



2.2.2 
2.2.4 

2.2 
2.2.2 



Full compression routine 



Reader disk file 



Compresses console input or reader input data that is 
transmitted to the host system. 

Processes all information read from disk files by the 
reader task. 



#MRHD 



#MRI1 



#MRI6 



#MRKP 



#MRMO 



#MROD 



#MROP 



2.2 
2.2.5 

2.1 



Host message processor 



Program load data and 
initialization processor 



2.1 


Storage allocation 




routine 


2.2 


Reader keyboard input 


2.2.2 


processor 


2.2.2.3 


MODIFY utility control 


2.2.4 


statement processor 


2.2.3.1 


Open disk processing 




routine 


2.2.3.1 


Open printer 




processing routine 



Displays received host messages on the system console 
and processes mount messages from the host system. 

Processes the program load data and the initialization 
display information. 

Determines the limits of MRJE storage and creates and 
initializes the MRJE data areas. 

Processes all information entered from a keyboard under 
the reader task. 

Processes the MODIFY utility control statement. 



Performs the open operations for MRJE disk output. 



Performs the open operations for all MRJE printer 
output. 



#MRRC 2.2 



Reader close routine 



Performs the close operations for information read by 
the reader task. 



#MRRF 



#MRRO 



#MRTM 



2.2.2.3 
2.2.4 



2.2.2 



#MRRP 2.2 
2.2.2 



2.3 



READFILE utility 
control statement 
processor 

Reader open routine 



Reader source get 
input processor 

Terminator 



Processes the READFILE utility control statement. 



Performs the open operations for disk files or library 
members read by the reader task. 

Processes all information read from members. 



Disables the adapter and displays a summary of BSC 
errors, deallocates TDISKPR1, and updates BSC I/O 
counters. 



#MRUP 



2.2 
2.2.3 



Printer output processor Controls all printer processing. 
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Data Areas 

BSC BUFFER 

BSC buffers are maintained in a free queue until needed 
for data transmission or until needed as buffers for 
receiving data from the host system. Following their use, 
buffers are returned to the free queue for later use. While 
in use, BSC buffers are maintained in a processor queue. 
The free queue is addressed by the field CTBUF@ in the 
CCT while the processor queue is addressed by the field 
PFBUF@ in each task's PFCB. Figure 2-10 illustrates 
BSC buffer queueing. 





CCT 


^^ Buffer Count (CTBUF#) 














CTBUF@ 




BSBCHN 




BSBCHN 












Buffer 1 


Buffer 2 




Free Queue 





PFCB 


_^. Buffer Count (PFCBCT) 














PFBUF@ 




BSBCHN 




BSBCHN 












Buffer 1 


Buffer 2 




Processor Queue 
Figure 2-10. Illustration of Buffer Queueing 
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Figure 2-1 1 shows the general format of a BSC buffer 
that is used for communication between the central and 
remote computers. 



DLE 



STX 



BCB 



FCS 



FCS 



RCB 



SRCB 



SCB 



SCB 



DATA 



SCB 



RCB 



SRCB 



SCB 



DATA 



SCB 



RCB 



DLE 



ETB 



BSC leader (DLE if transparency, SOH if no transparency) 

BSC start of text 

Block control byte 

Function control sequence 

Function control sequence 

Record control byte for record 1 

Subrecord control byte for record 1 

String control byte for record 1 



DATA Character string (1-63 characters) 



These 2 bytes are overlaid by 
BSBCHN (chain pointer to 
next buffer). 



FCS bytes become the pointer to the 
J- next RCB whenthe BSC buffer 
becomes a processor buffer. 



String control byte for record 1 

Character string (1-63 characters) 

Terminating string control byte for record 1 
Record control byte for record 2 
Subrecord control byte for record 2 
String control byte for record 2 

Character string (1-63 characters) 

Terminating string control byte for record 2 

Record control byte transmission block terminator 

BSC leader (DLE if transparency, SYN if no transparency) (not found in BSC buffer) 

BSC ending sequence 



Figure 2-11. General Format of a BSC Buffer 
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A typical BSC buffer for the MRJE utility is formatted as 
shown in Figure 2-12. 



Displacement of 




Leftmost Byte 




(Hexadecimal) 


Label 


00 


BSBCHN 


00 


BSBSOH 


01 


BSBSTX 


02 


BSBBCB 



03 



BSBFCS 



Length in 

Bytes 

(Decimal) 



Figure 2-12 (Part 1 of 6). Sample BSC Buffer for MRJE 



Description 

Chain pointer (address +1 ) to next buffer. Zero if last buffer on 
the chain. Overlaid during transmit and receive operations. 

BSC start of header (SOH), or data link escape (DLE) if 
transparency feature used. 

BSC start of text (STX). 

Block control byte (BCB). 



0XXXCCCC 



7 

Usage: Transmission block status and sequence count. 
Bit meanings: 

= 1 (must always be on). 

XXX = Control information as follows: 

= 000 Normal block 

= 001 Bypass sequence count validation 

= 010 Reset expected block sequence count to CCCC 

= 011 Reserved 

= 100 Reserved 

= 101 Not supported 

= 110 Not supported 

= 111 Reserved for future expansion 

CCCC = Modulus 16 block sequence count. 

Function control sequence (FCS). 



OS RRABCD 



OTRRWXYZ 



7 8 15 

Usage: To control the flow of individual function streams. 
Bit meanings: 

0=1 (must always be on). 



MRJE 2-33 
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Displacement of 
Leftmost Byte 
(Hexadecimal) Label 



Length in 

Bytes 

(Decimal) 



05 



BSBRCB 



Figure 2-12 (Part 2 of 6). Sample BSC Buffer for MRJE 
2-34 



Description 

S = 1 Suspend all stream transmission (wait-a-bit). 

Normal state 

T = Remote console stream identifier 
1 Console on 
Console off 

RR = Reserved for future expansion 

A = 1 Printer 1 on 
Printer 1 off 

Z = 1 Punch 1 on 
Punch 1 off 

Note: Bits BCD and WXY are not supported on System/34 and 
are always 1's. 

If a bit is on = continue function transmission; if a bit is off = 
suspend function transmission, 
individual functions.) 

Record control byte (RCB) 



I I I T T T T 



7 

Usage: To identify each record type within a transmission block. 

Bit meanings: 

= End of transmission block (I I ITTTT = 0) 
1 All other RCBs 

III = Stream identifier is used to identify streams of multiple 
identifical functions (multiple print streams to a multiple 
printer terminal, and so on). 
= Control information if TTTT = (control record) 
= 000 Reserved for future expansion 

Request to initiate a function transmission 

(prototype RCB for function in SRCB) 
Permission to initiate a function transmission 

(RCB for function contained in SRCB) 
Reserved 
Reserved 
Not supported 
Not supported 
General control record (type indicated in SRCB) 



= 001 

= 010 

= 011 
= 100 
= 101 
= 110 
= 111 
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Displacement of 
Leftmost Byte 
(Hexadecimal) 



Label 



Length in 








Bytes 








(Decimal) 


Description 








TTTT = 


Record-type identifier 




= 


0000 


Control record 




= 


0001 


Operator message display request 




= 


0010 


Operator command 




= 


0011 


Normal input record 




= 


0100 


Normal print record 




= 


0101 


Normal punch record 




= 


0110-1111 Not supported 



06 



BSBSRC 



Examples: 



hex 91 


= 


Console output 


hex 92 


= 


Console input 


hex 93 


= 


Reader 1 


hex 94 


= 


Printer 1 


hex 95 


= 


Punch 1 


hex A3 


= 


Reader 2 


hex B3 


= 


Reader 3 



Subrecord control byte (SRCB) 



OSSSSSSS 



7 

Usage: To provide supplemental information about a record. 

Bit meanings: 

O = 1 (must always be on) 

SSSSSSS = Additional record information; actual content is 
dependent on following record type listed: 

SRCB for General Control Record 



(character) 



Figure 2-12 (Part 3 of 6). Sample BSC Buffer for MRJE 



Usage: To identify the type of generalized control records. 



Bit meanings: 
character 



A Initial terminal signon/logon 

B Final terminal signoff/logoff 

C Print initialization record 

D Punch initialization record 

E Input initialization record 

F Data set transmission initialization 
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Displacement of 
Leftmost Byte 
(Hexadecimal) Label 



Length in 

Bytes 

(Decimal) 



Figure 2-12 (Part 4 of 6). Sample BSC Buffer for MRJE 



2-36 



Description 

= G System configuration status 

= H Diagnostic control record 

= I to R Reserved 

= S to Z Not supported 

SRCB for Print Records (Carriage Control Byte) 



OMCCCCCC 



7 

Usage: To provide carriage control information for print records. 

Bit meanings: 

O = 1 (must always be on) 

M = Normal carriage control 
1 Reserved for future use 

CCCCCC = Carriage control information 

= 1000NN Space immediately NN spaces 

= 11NNNN Skip immediately to channel NNNN 

= 0000NN Space NN lines after print 

= 01NNNN Skip to channel NNNN after print 

= 000000 Suppress space 

SRCB for Punch Records 



OMMBRRSS 



7 

Usage: To provide additional information for punch records. 

Bit meanings: 

O = 1 (must always be on) 

MM = 00 SCB count units = 1 

= 01 SCB count units = 2 

= 10 SCB count units = 4 

= 11 Reserved 

B = Normal EBCDIC card image 
1 Not supported 

RR = Reserved for future expansion 

SS = Punch stacker select information 
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Displacement of 
Leftmost Byte 
(Hexadecimal) Label 



Length in 

Bytes 

(Decimal) 



Figure 2-12 (Part 5 of 6). Sample BSC Buffer for MRJE 



Description 

SRCB for Input Records 



OMMBRRRR 



7 

Usage: To provide additional information for input records. 

Bit meanings: 

O = 1 (must always be on) 

MM = 00 SCB count units = 1 

= 01 SCB count units = 2 

= 10 SCB count units = 4 

= 1 1 Reserved 

B = Normal EBCDIC card image 
1 Not supported 

RRRR = Reserved 

SRCB for Terminal Message Routing Record 



OTTTTTTT 



7 

Usage: To indicate the destination of a terminal message. 

Bit meanings: 

= 1 (must always be on) 

TTTTTTT = Remote system number 

= Broadcast to all remote systems 

SRCB for RFTor GFT Records 



I I I T T T T 



7 

Usage: To identify the function for RFT or GFT control records. 
Bit meanings: 

= 1 (must always be on) 



MRJE 2-37 
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Displacement of 
Leftmost Byte 
(Hexadecimal) Label 



Length in 

Bytes 

(Decimal) 



07 



BSBSCB 



08 



BSBTXT 



Variable 
Length 



Figure 2-12 (Part 6 of 6). Sample BSC Buffer for MRJE 
2-38 



Description 

III = Stream identifier 
001 Stream 1 
010-111 Not supported 

TTTT = Record type identifier 

0011 NoVmal reader record 

0100 Normal printer record 

0101 Normal. punch record 
0110-1111 Not supported 

Examples: (These are the only identifiers supported on System/34). 

hex 94 = Printer 1 
hex 95 = Punch 1 
hex 93 = Reader 1 

String control byte (SCB) 



OKLJJJJJ 



7 

Usage: Control field for data character strings, used for data 
compression. 

Bit meanings: 

= End of record (KLJJJJJ = 0) 
= 1 All other SCBs 

K= Duplicate character string 

L = Duplicate character is blank 

L = 1 Duplicate character is nonblank (and follows SCB) 

JJJJJ = Duplication count (see Note 2) 

K = 1 Nonduplicate character string 

LJJJJJ = Character string length (see Note 2) 

Notes: 

1 . If KLJJJJJ = and 0=1, SCB indicates record is continued 
in next transmission block. 

2. Count units are normally 1 but may be in any other units. 
The units utilized may be indicated as function control or 
dynamically in the SRCB. 

Text terminated by next SCB. Last text string is terminated by 
SCB of zero. Last record in a block terminated by RCB of zero. 
A logical end of file (EOF) is an initial SCB of zero. 
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COMMUNICATION AND CONTROL TABLE 

The communication and control table (see Figure 2-13) 
contains addresses of the MRJE modules, information on 
the status of I/O devices, printer carriage control informa- 
tion, and other information of interest to more than one 
module. 

The address of the CCT is contained in low storage of the 
MRJE utility immediately following the characters CCT@. 
Also, each PFCB has the address of the CCT at PFCCT@. 



Displacement of 




Length in 


Leftmost Byte 




Bytes 


(Hexadecimal) 


Label 


(Decimal) 





CTPFC@ 


2 


2 


CTBUF1 


2 


4 


CTBBUF 


2 


6 


CTBUF@ 


2 


8 


CTBUF# 


1 


9 


CTFLG1 


1 



Description 

Address of first PFCB to be dispatched. 

Length of BSC buffers. 

Length of BSC buffers rounded up to nearest multiple of 8. 

Address of free buffer pool. 

Number of free buffers. 

Flag byte 1: 

hex 80 = MRJE has been initialized 

hex 40 = Processor has work 

hex 10 = Compression requested by user 

hex 08 = Signoff/logoff command has been read 

hex 04 = BSC connection has ended 

hex 02 = BSC error, 2 option taken 

hex 01 = Automatic mode 



A 



CTFLG2 



CTFLG3 



Figure 2-13 (Part 1 of 5). Communication and Control Table 



Flag byte 2: 


hex 40 : 


hex 20 : 


hex 10 : 


hex 02 = 


hex 01 : 


Flag byte 3: 


hex 80 : 


hex 40 : 


hex 20 : 


hex 10 : 


hex 08 : 


hex 04 : 


hex 02 : 


hex 01 : 



TDISKPR1 defined 
PDISKPR1 defined 
Current IOB is in a translated area 
System console is a reader 
Temporary work bit 



MRJE BSC trace active 

BSC task has a processor check 

Console input request from reader 1 task outstanding 

Termination of MRJE 

Console released 

Logoff sent to host 

Controlled cancel issued 

Termination, termination event block is valid 



MRJE 2-39 



Licensed Material— Property of IBM 



Displacement of 
Leftmost Byte 
(Hexadecimal) 



Label 
CTFHOS 



Length in 




Bytes 




(Decimal) 


Description 


1 


Host program type: 




hex FA = VM 




hex F9 = ASP 




hex F7 = HASP II 




hex F3 = JES III 




hex F2 = JES II 




hexF1 = RES 



D 


CTBSCDTF 


2 


F 


CTCNTUB@ 


2 


11 


CTCNTMID 


2 


13 


CTCSB@ 


2 


15 


CTMSG1 


2 


17 


CTMSG2 


2 


19 


CTPGSRT 


2 


1B 


CTPGEND 


2 


1D 


CTFORMAT 


2 


1F 


CTBSLN 


1 


20 


CTSTDPR1 


2 


22 


CTSPCPR1 


2 


24 


CTSPCPU1 


2 


26 


CTTCBTWA 


2 


28 


CTCARG 




29 


CTCHN1 




2A 


CTCHN2 




2B 


CTCHN3 




2C 


CTCHN4 




2D 


CTCHN5 




2E 


CTCHN6 




Figure 2-13 (Part 2 of 5). Communication and Control Table 


2-40 







BSC DTF address for #MRBP. 

Address of console TUB. 

Console terminal ID. 

Address of BSC CSB. 

NPPMSG1 address save area. 

NPPMSG2 address save area. 

Address of start area to build MR JE. 

Address of last byte (plus 1) of available area. 

Address of configuration information save area. 

Reserved. 

Printer disk block size (standard). 

Printer disk block size (special). 

Punch disk block size. 

Disk address of task work area. 

Number of lines per page. 

Channel 1 equivalence. 

Channel 2 equivalence. 

Channel 3 equivalence. 

Channel 4 equivalence. 

Channel 5 equivalence. 

Channel 6 equivalence. 
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Displacement of 




Length 


in 




Leftmost Byte 




Bytes 






(Hexadecimal) 


Label 


(Decimal) 


Description 


2F 


CTCHN7 


1 




Channel 7 equivalence. 


30 


CTCHN8 


1 




Channel 8 equivalence. 


31 


CTCHN9 


1 




Channel 9 equivalence. 


32 


CTCH10 


1 




Channel 10 equivalence. 


33 


CTCH11 


1 




Channel 1 1 equivalence. 


34 


CTCH12 


1 




Channel 12 equivalence. 


35 


CTJOB# 


4 




File sequence number. 


39 


CTDKID 


1 




First character of disk file form number 


3A 


CTRES2 


1 




Reserved. 


3B 


CTRES3 


1 




Reserved. 



The following 28 entries contain the addresses of the routines listed: 



3C 


CTDSGTUB 


2 


3E 


CTDSNEXT 


2 


40 


CTCONBUF 


2 


42 


CTBMGET 


2 


44 


CTBMPUT 


2 


46 


CTBMPURG 


2 


48 


CTBMGFT 


2 


4A 


CTBMRFT 


2 


4C 


CTBMEOF 


2 


4E 


CTBMQBUF 


2 


50 


CTBMFCON 


2 


52 


CTBMFCOF 


2 


54 


CTDSIOWT 


2 


56 


CTDSRFT 


2 



DSGTUB-get exclusive use of TUB. 
DSNEXT-return and skip turn. 
CONBUFO-address of console buffer. 
BMGET-get record from BSC buffer. 
BMPUT-put record into BSC buffer. 
BMPURG-purge buffers. 
BMGFT— put GFT sequence in buffer. 
BMRFT— put R FT sequence in buffer. 
BMEOF-put logical EOF in buffer. 
BMQBUF-add current BSC buffer to queue. 
BMFCON-tum on FCS bit in BSC PFCB. 
BMFCOF-tum off FCS bit in BSC PFCB. 
DSIOWT-wait for I/O completion. 
DSRFT-wait for RFT. 



Figure 2-13 (Part 3 of 5). Communication and Control Table 
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Displacement of 




Length in 


Leftmost Byte 




Bytes 


(Hexadecimal) 


Label 


(Decimal) 


58 


CTDSGFT 


2 


5A 


CTDSSTRT 


2 


5C 


CTDSWTO 


2 


5E 


CTDSWTOR 


2 


60 


CTBMFBUF 


2 


62 


CTMRFC 


2 


64 


CTBMSTRT 


2 


66 


CTDSWBUF 


2 


68 


CTDSWORK 


2 


6A 


CTBMCAN 


2 


6C 


CTBMDCOM 


2 


6E 


CTDSSKIP 


2 


70 


CTDSGCRT 


2 


72 


CTDSFCRT 


2 


74 


CTOVRLY1 


2 


76 


CTOVRLY2 


2 


78 


CTOVRLY3 


2 


7A 


CTPNTBUF 


2 


7C 


CTRD1BUF 


2 


7E 


CTBUFMAN 


2 


80 


CTTCB@ 


2 


82 


CTJCB@ 


2 


84 


CTWSINXA 


2 


86 


CTRDTABL 


2 


88 


CTSIGN@ 


2 



Description 

DSGFT-waitfor GFT. 

DSSTRT-wait for MODIFY statement. 

DSWTO-wait for WTO. 

DSWTOR-wait for WTOR. 

BMFBUF-free a BSC buffer. 

#MRFC— full compression module. 

BMSTRT— send start command to host system. 

DSWBUF-wait for buffers. 

DSWORK-wait for work. 

BMCAN— send cancel command to host system. 

BMDCOM— decompress a record. 

DSSKIP— skip a dispatching turn. 

DSGCRT— acquire display screen. 

DSFCRT— free display screen. 



Address of overlay area 1. 

Address of overlay area 2. 

Address of overlay area 3. 

Address of print buffer. 

Address of reader 1 buffer. 

Address of buffer manager. 

Address of MRJETCB. 

Address of MR JE JCB. 

Address of format index area. 

Address of active reader table. 

Address of rightmost byte of sign-on area. 



Figure 2-13 (Part 4 of 5). Communication and Control Table 



2-42 



N 
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Displacement of 




Length in 


Leftmost Byte 




Bytes 


(Hexadecimal) 


Label 


(Decimal) 


8A 


CTTIMER 


6 


90 


CTDLAYCT 


1 


92 


CTRDCNT 


2 



Description 

Delay value from END statement. 
Count of active data streams. 
Counter for FSB names for data files. 



Figure 2-13 (Part 5 of 5). Communication and Control Table 

PROGRAM FUNCTION CONTROL BLOCKS 

The MRJE utility uses the PFCBs (program function control 
blocks) to control the dispatching of the logical processors 
and to pass information between the various processors and 
$MRJE. There is a PFCB for each of the following: 

• BSC 

• Console input 

• Console output 

• Reader (up to 3) 

• Printer 

• Punch (optional) 

The beginning of each PFCB has the same description 
(see Figure 2-14). The remainder of the bytes are 
described separately in Figures 2-15 through 2-19. 
(Printer and punch PFCBs are described together.) 

The address of the first PFCB is contained in the CCT at 
CTPFC@. The address of the next PFCB in the chain is 
contained at PFNEXT in each PFCB. The last PFCB in 
the chain has an address of hex 0000 at PFNEXT. 
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Displacement of 




Leftmost Byte 




(Hexadecimal) 


Label 





PFNEXT 


2 


PFDTF@ 


4 


PFIOB@ 


6 


PFLAG1 



Length in 

Bytes 

(Decimal) 

2 

2 

2 

1 



PFLAG2 



PFLAG3 



Figure 2-14 (Part 1 of 3). Common PFCB Bytes 



2-44 



Description 

Address of next PFCB in chain. 

Address of current processor DTF. 

Address of current processor I OB. 

PFCB flag byte 1 : 

hex 80 = Processor waiting for I/O 

hex 40 = Processor waiting for buffers 

hex 20 = Processor waiting for GFT/R FT 

hex 10 = BSC SVC request pending 

hex 08 = General wait, between tasks 

hex 04 = Processor waiting for console message 

hex 02 = Processor waiting for MODIFY statement 

hex 01 = Processor waiting for work 

hex 00 = Processor is dispatchable 

PFCB flag byte 2: 

hex 80 = Option 1 halt error recovery (console I/O and reader) 

User requested task termination (print/punch) BSC 
post switch (BSC) 
hex 40 = Receive switch (BSC) 

End of file 
hex 20 = Two-second timer switch (BSC) 

I/O error 
hex 10 = End of extent (print/punch) 

Timer expired (console I/O and reader) 

Wait-a-bit (BSC) 
hex 08 = Local message switch (BSC) 

RFT/G FT received 
hex 04 = FCS on (BSC) 

Forms mount or READFILE pending 
hex 02 = FCS off (BSC) 

Terminate the task (print/punch) 
hex 01 = Signoff/logoff indicator (BSC) 

Controlled cancel pending 

PFCB flag byte 3: 

hex 80 = RFT needed (console I/O and reader) 

hex 40 = Signoff/logoff command indicator (console I/O) 

Data written to disk file (print/punch) 
hex 20 = Start command required (console I/O) 

Decompression required for retry (print/punch) 
hex 10 = Console interrupt honored (console I/O) 

PDISKPR1 file being used (print/punch) 
hex 08 = First-time switch (reader) 
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Displacement of 
Leftmost Byte 
(Hexadecimal) Label 



Length in 

Bytes 

(Decimal) 



Description 

hex 04 = Log device message required (console and reader) 
#MRCL is processing an error (print/punch) 

hex 02 = MODIFY statement pending 

hex 01 = #MRCL will switch output device (print/punch) 
Disk data file read pending or library member 
remaining bytes pending (reader) 



9 


PFLAG4 


1 


SRCB for print task. 


A 


PFBUF@ 


2 


Address of BSC buffer chain. 


C 


PFMBCT 


1 


Maximum BSC buffer count. 


D 


PFCBCT 


1 


Current BSC buffer count. 


E 


PFPRI@ 


2 


Primary dispatching address. 


10 


PFRES@ 


2 


Processor resident code address. 


12 


PFMSG# 


2 


MIC for output. 


14 


PFCCT@ 


2 


CCT address. 


16 


PFRCB1 


1 


Processor record control byte: 



17 



PFPRIQ 



18 


PFTMID 


2 


1A 


PFTUB@ 


2 


1C 


PFMSGR 


1 



Figure 2-14 (Part 2 of 3). Common PFCB Bytes 



hex B3 = Reader 3 PFCB 

hex A3 = Reader 2 PFCB 

hex 95 = Punch PFCB 

hex 94 = Printer PFCB 

hex 93 = Reader 1 PFCB 

hex 92 = Console input PFCB 

hex 91 = Console output PFCB 

hex 00 = BSC PFCB 

Primary device Q-byte: 

hex E0 = Printer 

hex A0 = Disk 

hex 10 = keyboard, display screen 

Work station terminal ID. 

Work station TUB address. 

Operator reply to message. 
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Displacement of 




Length in 


Leftmost Byte 




Bytes 


(Hexadecimal) 


Label 


(Decimal) 


1D 


PFLFLG 


1 



1E PFNXNM 

24 PFTRAR 

26 PFLAG5 



Description 

Transient load list flags: 

hex 80 = Leave module in transient area 

hex 10 = Transient area shared 

hex 02 = Return to dispatcher via PFSAR@ 

hex 01 = Dispatch resident code 

Name of next module to execute. 

Address of transient control. 

PFCB flag byte 5: 

hex 80 = Printer already allocated (printer) 

Current EOF flag (reader) 
hex 40 = TDISKPR1 already allocated (printer) 

EOF save flag (reader) 

Processing user request (BSC) 
hex 20 = IOB address not real 
hex 10 = #MRBO terminating abnormally (BSC) 

Reader display station has been released (reader) 
hex 08 = Display station is invited 
hex 04 = Display station has a permanent I/O error 



27 


PFMSGV 


10 


Variable data for message output 


31 


PFSAR@ 


2 


Save area for dispatcher service. 


33 


PFPBF@ 


2 


Address of processor buffers. 


35 


PFSXR1 


2 


Save area for XR1. 


37 


PFSARR 


2 


Save area for ARR. 


39 


PFHXR1 


2 


Hold area for XR1. 


3B 


PFHARR 


2 


Hold area for ARR. 


3D 


PFRCNT 


3 


Input/output record count. 


40 





1 


Reserved. 



Figure 2-14 (Part 3 of 3). Common PFCB Bytes 
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Displacement of 
Leftmost Byte 
(Hexadecimal) 

through 40 

41 

43 

45 

47 

49 

4B 

4D 

4F 

51 

53 

55 

57 

59 

5A 

5B 

5D 

5F 

61 

62 

63 

64 

65 

6A 

73 



Label 

See Figure 2-14. 

PFBBSN 

PFBBLN 

PFBRW1 

PFBRW2 

PFBXW1 

PFBWX2 

PFBR1 

PFBR2 

PFBX1 

PFBX2 

PFBX1S 

PFBX2S 

PFBRBC 

PFBSBC 

PFBNFS 

PFBRFS 

PFBXFS 

PFBWRK 

PFBSSN 

PFBCTR 

PFBMER 

PFBSEQ 

PFBERR 

PFBXWB 



Length in 

Bytes 

(Decimal) Description 



BSC sense information. 

Length of transmit/receive operation. 

Start of receive address for wait-a-bit. 

End of receive address for wait-a-bit. 

Start of transmit address for wait-a-bit. 

End of transmit address for wait-a-bit. 

Start of receive address. 

End of receive address. 

Start of transmit address. 

End of transmit address. 

Save start of transmit address. 

Save end of transmit address. 

Expected BCB from host system. 

Next transmitted BCB to host system. 

Next transmitted FCS to host system. 

Last received FCS from host system. 

Last transmitted FCS to host system. 

BSC work byte. 

Temporary BSC sense save. 

Bad receipt counter. 

Maximum BSC error count. 

DLE-STX-BCB-FCS-FCS. 

DLE-STX-LBCBKSP-FCS-FCS-ERR-ERR-ERR-ETB. 

Wait-a-bit sequence. 



Figure 2-15 (Part 1 of 2). BSC PFCB 
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Displacement of 




Length in 




Leftmost Byte 




Bytes 




(Hexadecimal) 


Label 


(Decimal) 


Description 


7C 


PFBRWB 


9 


Receive area for wait-a-bit reply. 


85 


PFBSTX 


2 


DLE-STX. 


87 


PFBETB 


2 


Logical EOB-physical ETB. 


89 


PFBACK 


2 


DLE-ACKO. 


8B 


PFBTBS 


2 


Number of text blocks sent. 


8D 


PFBTBR 


2 


Number of text blocks received. 


8F 


PFBNKR 


2 


Number of NAKs received. 


91 


PFBLDE 


2 


Number of lost data errors. 


93 


PFBINR 


2 


Number of invalid responses. 


95 


PFBRTO 


2 


Number of receive time-outs. 


97 


PFBDCK 


2 


Number of data checks. 


99 


PFBACT 


2 


Number of transmit adapter checks 


9B 


PFBACR 


2 


Number of receive adapter checks. 


9D 


PFBASC 


2 


Not used. 


9F 


PFBABR 


2 


Number of aborts received. 


A1 


PFBDTO 


2 


Number of disconnect time-outs. 


A3 


PFBBRV 


2 


Reserved. 


A5 


PFBBMG 


4 


BSC PFCB message area. 


A9 


- 


3 


Reserved. 


AC 


PFBIA@ 


2 


Interrupt routine entry point. 


AE 


PFBIS@ 


2 


Interrupt routine switch address. 


BO 


PFBGB@ 


2 


Get buffer subroutine entry point. 


B2 


PFBP1@ 


2 


Interrupt routine post address. 


B4 


PFBP2@ 


2 


Interrupt routine post address. 


B6 


PFBQR 


2 


Q- and R-bytes of last SIO. 


B8 


PFBCAR 


2 


Current address register at last SIO. 



Figure 2-15 (Part 2 of 2). BSC PFCB 
2-48 
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Displacement of 




Length in 




Leftmost Byte 




Bytes 




(Hexadecimal) 


Label 


(Decimal) 


Description 


through 40 


See Figure 2-14. 






41 


PFREC@ 


2 


Input record address. 


43 


PFRLEN 


2 


Input record length. 


45 


- 


18 


Reserved. 


57 


WACIB 


16 


Console input IOB. 


67 


WACSIZ 


133 


Console input buffer 



Figure 2-16. Console Input PFCB 



Displacement of 
Leftmost Byte 
(Hexadecimal) 

through 40 

41 

43 

45 

47 

48 

4A 



Label 

See Figure 2-14. 

PFREC@ 

PFRLEN 

PFMSGQ 

PFMQCT 

PFQNXT 

WAMSGQ 



Length in 

Bytes 

(Decimal) Description 



2 Output record address. 

2 Output record length. 

2 Message queue address. 

1 Message queue available counter (8=empty, 0=full) 

2 Next message to be processed by console output. 
152 Local message queue. 



Figure 2-17. Console Output PFCB 
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(Hexadecimal) 
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through 40 


See Figure 


2-14. 








41 


PFREC@ 




2 




Input record address. 


43 


PFRLEN 




2 




Input record length. 


45 


PFREAD 




8 




Current READFILE name 


4D 


PFRFTY 




1 




Current READFILE type. 



Figure 2-18 (Part 1 of 2). Reader PFCB 
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Displacement of 




Length in 


Leftmost Byte 




Bytes 


(Hexadecimal) 


Label 


(Decimal) 


4E 


PFRCMD 


1 


4F 


PFRCRA 


3 


52 


PFREND 


3 


55 


PFRDSV 


8 


5D 


PFRTYS 


1 


5E 


PFRCMS 


1 


5F 


PFRDAT 


6 


65 


PFQSAV 


1 


66 


PFRLNS 


2 


68 


PFRSSV 


3 



6B 



PFRDSS 



6E 


PFNAME 


2 


70 


PFNAMS 


2 


72 


WARRCL 


2 


74 


WARLSR 


4 


78 


WAREND 


3 


7B 


WARF1 


64 


or 


WARBUF 


93 


D9 


WRCUOF 


2 


DB 


WRCURC 


2 


DD 


WCUOFS 


2 


DF 


WCURCS 


2 


E1 


WARIOB 


28 



Description 

Current READFILE command indicator. 

Next available sector address in READFILE. 

Ending sector address in READFILE. 

File name from READFILE save area. 

File member type save area. 

File indicator save area. 

File creation date. 

Device Q-byte. 

Record length in READFILE. 

Disk file current address or library member. 
I/O buffer offset and displacement save area. 

Disk file current address or library member. 
I/O buffer offset and displacement save area. 

Count value for FSB file names. 

Save count value for FSB file names. 

Logical record length. 

Next available record address. 

File end sector address. 

Format 1 work area. 

Input buffer 

Current disposition in processor buffer. 

Byte count in processor buffer. 

Processor buffer disposition. 

Processor buffer count. 

Disk IOB for reader. 



Figure 2-18 (Part 2 of 2). Reader PFCB 
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Displacement of 
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Leftmost Byte 




Bytes 




(Hexadecimal) 


Label 


(Decimal) 


Description 


through 40 


See Figure 2-14. 






41 


PFREC@ 


2 


Output record address. 


43 


PFRLEN 


2 


Output record length. 


45 


PFDEOD 


2 


Sector address of end of data. 


47 


PFCURC 


2 


Byte count in processor buffer. 


49 


PFNXFM 


4 


Next forms mount number. 


4D 


PFRS# 


5 


RES response number (first 2 bytes only). 


or 


PFRM# 


5 


HASP/JES2 remote number (first, 4 bytes only 


or 


PFRMID 


5 


ASP/JES3 remote ID. 


52 


PFQMDS 


1 


MODIFY statement Q-byte. 


53 


- 


4 


Reserved. 


57 


PFTCNT 


3 


TDISKPR1 record count. 


5A 


PFTCNS 


3 


TDISKPR1 record count save. 


5D 


PFHOLD1 


2 


Work area. 


5F 


PFHOLD2 


2 


Work area. 


61 


PFHCNT1 


3 


Work area. 


64 


PFHDNT2 


3 


Work area. 


67 


PFRRCN 


3 


File record count. 


6A 


PFSCUR 


1 


Save PFCURC for TDISK. 


6B 


PFAFAA 


2 


Address of current format 1 in assign/free area 


6D 


PFCNLT 


13 


Temporary carriage table. 


7A 


WADSWA 


64 


Disk I/O area. 


BA 


WADBMW 


20 


Buffer manager work area. 


CE 


WAIOB@ 


28 


Disk IOB for printer/punch. 



Figure 2-19. Printer/Punch PFCB 
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Appendix A. Data Communications Print Utility 



Introduction 



ERROR HANDLING 



The data communications print utility is an SSP utility 
that prints data that was written to disk during an MRJE 
utility session. The print utility can process any number 
of disk files and any number of contiguous records within 
each file. For a description of the utility control state- 
ments required to run the utility, see the Data Communica- 
tions Reference Manual. Figure A-1 describes the function 
of this utility. 



When an error condition is detected by this utility, it is 
processed through the system logging function. Operator 
intervention is required to select a retry of the operation 
or a controlled cancel. On a controlled cancel, control 
is returned to the utility, which calls end of job. 



SYSTEM REQUIREMENTS 

The data communications print utility is part of the 
System/34 SSP and executes in 8K bytes of main storage. 
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Method of Operation 

Figure A-1 describes the logical function of $DCSUP 
using an input-process-output diagram. For detailed 
information on the input-process-output diagram, see 
Diagram Techniques in How to Use This Manual at the 
front of this publication. 



From: Program Initiation 



■ INPUT 



Utility control 
statements 

VTOC 
format 1 



Disk output 




PROCESS 



> 



Reads control statements from the system 
input device. 

Reads the VTOC format 1's. 



Initializes DTFs. 

Reads records from the input file, 
constructs print lines, and prints the 
file using printer data management. 



> 




OUTPUT 



IOB 
Printed file 



To: Termination 



DESCRIPTION 



MODULE/ 
ROUTINE 



| Reads the COPYFILE, SELECT, and CARRIAGE utility control statements from the system input device. 

| Reads the VTOC format 1's describing the MRJE/WS disk output files to be used as input to the utility. 

| The information contained in the VTOC format 1's is used to format the disk IOB and do an initial 2-sector read 
of the input file. 

| Reads records from the data communication utility disk files and constructs print lines, converting the host 
system carriage control information into the proper carriage command. The print lines are printed using 
printer IOS. When end of file is reached for the input disk file, the print utility reads another utility control 
statement from the system input device. The print utility goes to end of job after reading END or after an 
operator responds to a message with a 2 option. 



$DCSUP 



Figure A-1. Printing Disk Output 
A-2 
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Glossary 



ACKO: The even-numbered positive acknowledge 
sequence. 

ACK1: The odd-numbered positive acknowledge 
sequence. 

address translation register: ATR. 

addressing: The means by which a sending or control 
station selects the unit to which it will send a message. 

American National Standard Code for Information 
Interchange: ASCII. 

ASCII: American National Standard Code for Informa- 
tion Interchange. 

ASP: Asymmetric multiprocessing system. 

asymmetric multiprocessing system: ASP. 

ATR: Address translation register. 

auto-answer: A machine feature that permits a station 
to respond to a call it receives over a switched line 
without operator action. 

auto-call: A machine feature that permits a station to 
initiate a connection with another station over a switched 
line without operator action. 

basic telecommunications access method: BTAM. 

BCB: Block control byte. 

BCC: Block check character. 

binary synchronous communications (BSC): A flexible 
form of line control that provides a set of rules for 
transferring data over a communications line connecting 
two or more devices that use a communications adapter. 

block control byte: BCB. 

block check character: BCC. 

bps: Bits per second. 



BSC: Binary synchronous communications. 

BTAM: Basic telecommunications access method. 

call: The action performed by the requesting party, the 
operations necessary to make a request, or the effective 
use made of a connection between two stations. 

CCP: Communications control program. 

CCT: Communication and control table. 

central station: See control station. 

clocking: A method of controlling the number of data 
bits sent on a data communications line in a given time. 

command file: A disk file, procedure member, or source 
member that is designated as a command file by a data 
communications utility program. A command file can 
contain utility control statements and/or records to be 
transmitted to the host system. 

communication and control table: CCT. 

communication specification block: CSB. 

communications adapter: A hardware feature that 
enables System/34 to become a part of a data 
communications network. 

communications control program: CCP. 

compression: A technique for removing strings of 
duplicate characters and truncating trailing blanks before 
transmitting data. 

configuration record: See system configuration record/ 
display station configuration record. 

control station: The primary or controlling computer in 
a multipoint data communications configuration. The 
control station controls the sending and receiving of 
data. 

conversational file: A BSC file that allows receiving or 
sending data characters as an acknowledgment instead 
of the ACKO or ACK1 sequence. 
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CSB: Communication specification block. 

data communications: The transmission of data between 
systems and/or remote devices over a communications 
line. 

data file: A disk file procedure member, or source 
member that is designated as a data file by a data 
communications utility program. A data file can contain 
only records to be transmitted to the host system. 

data link: The equipment and rules (protocols) used for 
sending data over a communications line. 

data link escape (DLE): A control character used 
exclusively to provide supplementary line-control signals 
(control character sequences or DLE sequences). 

data mode: A time at which BSC is transmitting or 
receiving characters on the line. 

data stream: All data transmitted over a data link in a 
single read or write operation. 

DISC: The transmission control sequence for disconnect 
on a switched line. 

disconnect time-out: An indication that the BSC station 
you were communicating with has gone on hook or 
hung up. 

disk operating system: DOS. 

display station: An input/output device containing a 
display screen on which data is displayed and an 
attached keyboard from which data is entered. 

display station configuration record: An area on disk 
that describes a command display station's environment. 
The display station's configuration record contains 
information such as the session date, the work station 
ID of the printer to be used for the display station's 
printed output, and the region size for jobs submitted 
from the display station. 

DLE: Data link escape. 

DOS: Disk operating system. 

duplex: Concurrent transmission and reception of data. 

EBCDIC: Extended binary-coded decimal interchange 
code. 



EBCDIC transparency: See transparent text mode. 

end of transmission: EOT. 

ENQ: Enquiry character. 

EOT: End of transmission. 

error history file: A push-down stack of the last BSC 
errors that have occurred. 

ETB: End-of-transmission-block character. 

ETX: End-of-text character. 

expanded communications buffer: A special feature 
of the 3741 that allows multiple records to be trans- 
mitted or received in one block of data. 

extended binary-coded decimal interchange code: 
EBCDIC. 

extent: A continuous space on disk or diskette that is 
occupied by, or reserved for, a particular file. 

GFT: Grant function transmission. 

grant function transmission: GFT. 

half duplex: Data communications in opposite directions, 
but not at the same time. 

host system: The primary or controlling computer in 
the communications network. See also control station. 

intermediate block check: A function that permits 
checking of each record, instead of checking the contents 
of the total buffer when large buffers of data are 
received. 

interrecord separator: The last character of a record that 
signals the end of that record and the beginning of 
another record on a data communications network. 

ITB: Intermediate-text-block character. 

JES2: Job entry subsystem 2. 

JES3: Job entry subsystem 3. 
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line control characters: See transmission control 
characters. 

manual answer: Operator actions to make a station 
ready when a station receives a call over a switched 
line. 

manual call: Operator actions to make a connection 
with a station over a switched line. 

MLMP: Multiline multipoint. 

modem (modulator/demodulator): A device that 
connects a communications adapter to a communica- 
tions line. 

monitor mode: A time during which the communica- 
tions adapter is looking for BSC synchronization 
characters. 

MRJE: MULTI-LEAVING Remote Job Entry. 

MSP/7: Modular system programs. 

MULTI-LEAVING Remote Job Entry (MRJE): An 

SSP function that allows the user to communicate with 
a System/370 over a communications line using BSC. 

multidropped terminal: See tributary station. 

multiline multipoint: MLMP. 

multipoint data link: A network configuration in which 
connected stations communicate with each other over a 
common communications line on a time-shared basis. 
The primary station controls and maintains the data link. 

NAK: Negative acknowledgment character. 

NCP: Network control program. 

network: A configuration by which two or more 
stations can communicate. 

network control program: NCP. 

nonswitched line: A connection between systems or 
devices that does not have to be made by dialing. 

operating system: OS. 

OS: Operating system. 



PFCB: Program function control block. 

point-to-point line. A data communications facility that 
connects a single remote station to a data processing 
system. A point-to-point line can be either switched or 
nonswitched. 

polling: In a multipoint environment, a request to send, 
transmitted from the primary station to a specific 
secondary station. 

POWER: Priority output writers, execution processors, 
and input readers. 

program function control block: PFCB. 

receive mode: A time during which the BSC adapter 
looks for synchronization characters and then stores the 
data characters in main storage. 

receive time-out: An indication that no data has been 
received by this communications adapter in a given 
period of time. 

remote entry services: RES. 

remote job entry: RJE. 

remote spooling communications system: RSCS. 

request function transmission: RFT. 

RES: Remote entry services. 

reverse interrupt (RVI): A request by the receiving 
station to the sending station to stop transmitting and 
prepare to receive a message. 

RFT: Request function transmission. 

RJE: Remote job entry. 

RSCS: Remote spooling communications system. 

RVI: Reverse interrupt character. 

session: The period of time during which programs or 
devices can communicate with each other. 

SOH: Start-of-heading character. 
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standby line: A modem feature that allows a point-to- 
point, nonswitched line modem to also function on a 
point-to-point, switched line. 

station: A system or device that can send or receive 
data over a communications line. 

STX: Start-of-text character. 

switched line: A connection between two stations 
that is established by dialing. 

SYN: Line synchronization character. 

system configuration record: Information stored on disk 
that describes system characteristics and programming 
support; for example, system data format, disk capacity, 
and main storage capacity. 

system console: A display station designated to 
activate specific system functions, and to control and 
monitor system operation, in addition to performing 
as a command display station. 

task control block: TCB. 

TCAM: Telecommunications access method. 

TCB: Task control block. 

telecommunications access method: TCAM. 

terminal unit block: TUB. 

text transparency: A provision that allows BSC to send 
and receive messages containing any or all of the 256 
character combinations in EBCDIC, including trans- 
mission control characters. EBCDIC and control 
characters are all sent as text. 

transmission control characters: Special characters 
that are included in a message to control communication 
over a data link. 



transparency: See transparent text mode. 

transparent text mode: A method of binary 
synchronous transmission in which only transmission 
control characters preceded by the DLE control 
character are processed as transmission control 
characters. 

tributary station: A secondary or noncontrolling device 
in a multipoint data communications configuration. 

TTD: Temporary-text-delay sequence. 

TUB: Terminal unit block. 

virtual machine: VM. 

virtual storage: VS. 

virtual telecommunications access method: VTAM. 

VM: Virtual machine. 

VS: Virtual storage. 

VTAM: Virtual telecommunications access method. 

WACK (wait before transmit positive acknowledgment): 

The DLE sequence sent by a receiving station to indicate 
that it cannot receive data at present. 

work station: A device that lets a person transmit 
information to or receive information from a computer, 
or both, as required to perform the job. 

wrap test: A test that checks attachment or controller 
circuitry without testing the device itself. 

WTO: Write to operator. 

WTOR: Write to operator with reply. 
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Index 



BSC 

#BSATR (address translation) 

control flow none 

diagram 1-27 
#BSAUTO (receive-initial initiator) 

control flow 1-33 

diagram 1-10 
#BSCKRI (check receive-initial command) 

control flow 1-33 

diagram 1-10 
#BSCL (close) 

control flow 1-37 

diagram 1-9,1-26,1-28 
#BSCP (blank compression and expansion) 

control flow 1-35 

diagram 1-21 
#BSDB (data management for get and put) 

control flow none 

diagram 1-18 
#BSHB (operation end processor) 

control flow 1-38 

diagram 1-15,1-22 
#BSIO (BSC IOS) 

control flow 1-38 

diagram 1-10- 1-13 
#BSIW (wait) 

control flow 1-31 

diagram 1-15,1-20,1-25,1-26 
#BSL0 (line initialization) 

control flow 1-32 

diagram 1-9,1-18 
#BSL2 (line initialization) 

control flow 1-34 

diagram 1-11 
#BSL3 (line initialization) 

control flow 1-34 

diagram 1-12 
#BSL4 (line initialization) 

control flow 1-34 

diagram 1-11,1-13 
#BSMD (message transient) 

control flow 1-38 

diagram none 
#BSMG (data receive) 

control flow 1-36 

diagram 1-16 
#BSMLTP (multipoint router on new file) 

control flow 1-33 

diagram 1-10 
#BSMO (move) 

control flow none 

diagram 1-17 
#BSMP (data blocking) 

control flow 1-35 

diagram 1-18,1-21 
#BSMPEOT (send EOT) 

control flow 1-33 

diagram 1-10 



#BSOB (open) 

control flow 1-31 

diagram 1-8 
#BSPOST (post) 

control flow 1-36 

diagram 1-18 
#BSRI (receive-initial initiator) 

control flow 1-33 

diagram 1-10 
#BSXP (blank expansion) 

control flow 1-36 

diagram 1-17 



address translation (see #BSATR) 



blank compression and expansion (see #BSCP) 
blank expansion (see #BSXP) 
BSC IOS (see#BSIO) 



check receive-initial command (see #BSCKRI) 

close (see#BSCL) 

closing files 1-3 

commands 1-4 

control flow diagrams 1-30 

control statements 1-4 

control storage interface 1-3 



data areas 1-34 

data blocking (see #BSMP) 

data management for get and put (see #BSDB) 

data receive (see #BSMG) 

diagram techniques vii 

directory 1-39 



error recovery 1-5 



functional organization 1-1 
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user program interface 1-4 



hardware interface 1-4 



wait (see#BSIW) 



input 1-4 
interfaces 1 -4 
introduction 1-1 



line initialization (see #BSL0, #BSL2, #BSL3, or #BSL4) 



message transient (see #BSMD) 

method of operation 1-7 

move (see #BSMO) 

multipoint router on new file (see #BSMLTP) 



open (see #BSOB) 

opening files 1-2 

operation end processor (see #BSHB) 

operational considerations 1-4 

organization of this manual v 

output 1-4 



post (see #BSPOST) 
program organization 



1-30 



receive-initial initiator (see #BSAUTO or #BSRI) 
receiving data 1-2 



send EOT (see #BSMPEOT) 
SSP interface 1-4 
storage map 1-30 
system requirements 1-6 



terminating 1-3 
transmitting data 



1-2 
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MRJE 

#MRBE (BSC error recording) 

control flow none 

diagram 2-9 
#MRBM (buffer manager) 

control flow none 

diagram 2-1 0, 2-1 6, 2-20, 2-21 
#MRBO (BSC open) 

control flow 2-24 

diagram 2-7 
#MRBP (BSC I/O processor) 

control flow 2-24 

diagram 2-8, 2-9 
#MRCD (console output processor) 

control flow none 

diagram 2-8, 2-21 
#MRCL (printer/punch close) 

control flow 2-27 

diagram 2-16 
#MRCO (utility control statement processor) 

control flow 2-28 

diagram 2-11,2-20 
#MRCP (console input processor) 

control flow 2-26 

diagram 2-8 
#MRCR (CARRIAGE processor) 

control flow 2-28 

diagram 2-14,2-20 
#MRCS (utility control statement scanner) 

control flow 2-28 

diagram 2-14,2-20,2-21 
#MRDP (disk output processor) 

control flow 2-27 

diagram 2-8,2-16 
#MRFC (full compression routine) 

control flow none 

diagram 2-10,2-20 
#MRFR (reader disk file) 

control flow none 

diagram 2-8,2-10 
#MRHD (host message processor) 

control flow none 

diagram 2-8, 2-21 
#MRI1 (initialization processor) 

control flow 2-24 

diagram 2-7 
#MRI6 (storage allocation) 

control flow 2-24 

diagram 2-7 
#MRKP (reader keyboard input processor) 

control flow 2-25 

diagram 2-8,2-10 
#MRMO (MODIFY processor) 

control flow 2-28 

diagram 2-14,2-20 
#MROD (open disk processing) 

control flow none 

diagram 2-17 
#MROP (open printer processing) 

control flow 2-27 

diagram 2-17 



#MRRC (reader close routine) 

control flow 2-26 

diagram 2-8 
#MRRF (READFILE processor) 

control flow 2-28 

diagram 2-14, 2-20 

#MRRO (reader open routine) 

control flow 2-26 

diagram 2-1 
#MRRP (reader source get input processor) 

control flow none 

diagram 2-8,2-10 
#MRTM (terminator) 

control flow none 

diagram 2-22 
#MRUP (printer output processor) 

control flow 2-27 

diagram 2-8,2-16 



BSC buffer 2-31 
BSC error recording (see #MRBE) 
BSC I/O processor (see #MRBP) 
BSC open (see#MRBO) 
buffer manager (see #MRBM) 



CARRIAGE processor (see #MRCR) 
communication and control table 2-39 
console input processor (see #MRCP) 
console output processor (see #MRCD) 
control flow diagrams 2-24 
control storage interface 2-4 



data areas 2-31 

data communications print utility A-1 

diagram techniques vii 

directory 2-29 

disk output processor (see #MRDP) 



error recovery 2-4 



full compression routine (see #MRFC) 
functional organization 2-1 
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utility control statement processor (see #MRCO) 
utility control statement scanner (see #MRCS) 



hardware interface 2-4 

host message processor (see #MRHD) 



initialization 2-1 

initialization processor (see#MRI1) 

input 2-2 

interfaces 2-4 

introduction 2-1 



method of operation 2-6 
MODIFY processor (see #MRMO) 



open disk processing (see #MROD) 
open printer processing (see #MROP) 
organization of this manual v 
output 2-2 



printer output processor (see #MRUR) 
printer/punch close (see #MRCL) 
processing 2-2 

program function control blocks 2-43 
program organization 2-23 



reader close (see #MRRC) 

reader disk file (see #MRFR) 

reader keyboard input processor (see #MRKP) 

reader open routine (see #MRRO) 

reader source get input processor (see #MRRP) 

READFILE processor (see #MRRF) 



SSP interfaces 2-4 
storage allocation (see #MRI6) 
storage map 2-23 
system requirements 2-5 



termination 2-2 
terminator (see #MRTM) 



X-4 



Licensed Material— Property of IBM 



ntni/bn *» wv 



Please use this form only to identify publication errors or request changes to publications. Technical questions about IBM systems, changes in IBM programming 
support, requests for additional publications, etc, should be directed to your IBM representative or to the IBM branch office nearest your location. 



Error in publication (typographical, illustration, and so on). No reply. 
Page Number Error 



Inaccurate or misleading information in this publication. Please tell us 
about it by using this postage-paid form. We will correct or clarify the 
publication, or tell you why a change is not being made, provided you 
include your name and address. 

Page Number Comment 



r - en — 
o < ro 



o n> 
^ 3 



£53 



D 

0) ^ 
£) O 

S3 

3 



S -^ 



Note: All comments and suggestions become the property of IBM. 



No Dostaae necessary if mailed in the U.S.A. 



Name 



Address 



LY2 1-005 1-0 



Fold 



Fold 



FIRST CLASS 
PERMIT NO. 40 
ARMONK, N. Y. 



BUSINESS REPLY MAIL 

NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STATES 



POSTAGE WILL BE PAID BY 



IBM Corporation 
General Systems Division 
Development Laboratory 
Publications, Dept. 245 
Rochester, Minnesota 55901 




Fold 



Fold 



International Business Machines Corporation 

General Systems Division 
4111 Northside Parkway N.W. 
P.O. Box 2150 
Atlanta, Georgia 30301 
(U.S.A. only) 

General Business Group/International 

44 South Broadway 

White Plains, New York 10601 

U.S.A. 

(International) 



International Business Machines Corporation 

General Systems Division 
41 1 1 Northside Parkway N.W. 
P.O. Box 2150 
Atlanta, Georgia 30301 
(U.S.A. only) 

General Business Group/International 

44 South Broadway 

White Plains, New York 10601 

U.S.A. 

(International) 



LY21-0051-0 

Licensed Material — Property of IBM 



